@personaxis/persona.md

CLI for PERSONA.md — define, validate, lint, and compile AI agent personas.

Full documentation lives in the PERSONA.md spec repository.

---

Quick start

npx @personaxis/persona.md init
npx @personaxis/persona.md validate
npx @personaxis/persona.md lint
npx @personaxis/persona.md compile --target claude-code

Requires Node.js 18+.

---

Commands

Command	Description
init	Create a PERSONA.md interactively
validate	Schema validation — exits 1 if invalid
lint	Semantic lint — 8 rules, structured findings
compile --target <t>	Compile to claude-code, cursor, or soul-md
export --format json	Export frontmatter as JSON
diff <before> <after>	Compare two versions field by field
spec	Print the spec — useful for injecting into agent prompts
use <template>	Scaffold a persona from a template
list	List personas installed in this project
templates	List built-in templates

See github.com/personaxis/persona.md for the full CLI reference, lint rules, programmatic API, and examples.

---

License

MIT.