Package Exports
- matilha
- matilha/dist/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (matilha) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
matilha — CLI
You lead. Agents hunt. Methodology harness CLI for AI-assisted software development.
🏠 This is the CLI twin. The official matilha entry point is danilods/matilha-skills — the Claude Code plugin ecosystem with 146 skills across 7 companion packs. This CLI is the deterministic engine for power-user workflows, CI, and automation. For interactive development inside Claude Code, start with the plugin.
Install
npm install -g matilha
matilha --versionInstall the ecosystem (core + 7 packs)
Interactive — pick your packs
matilha install-pluginsLaunches a guided picker:
- Choose a preset or Custom to select packs individually
- Confirm whether to write the CLAUDE.md activation snippet
- Copies the install block to clipboard (paste in Claude Code) — or add
--deepto install directly
Presets available: backend · ux · fullstack · security · core-only · custom
Non-interactive — install everything in one shot
matilha install-plugins --full --deep --with-claudemdWhat --full --deep --with-claudemd does:
- Adds
danilods/matilha-skillsto the Claude Code marketplace - Runs
claude plugin installfor each of the 8 plugins (core + 7 packs) - Writes the activation-priority snippet to
./CLAUDE.md
Then in Claude Code: /reload-plugins → done.
All flags
| Flag | Effect |
|---|---|
| (no flags) | Interactive picker — preset or custom multiselect |
--full |
Non-interactive: core + all 7 companion packs |
--core-only |
Non-interactive: core plugin only |
--preset <name> |
Non-interactive: backend · ux · fullstack · security |
--deep |
Run claude plugin install directly instead of emitting a paste block (requires claude CLI on PATH) |
--with-claudemd |
Also write/merge the CLAUDE.md activation-priority snippet |
--no-clipboard |
Print paste block to stdout instead of copying to clipboard |
Commands
matilha --help| Command | Phase | Description |
|---|---|---|
install-plugins |
— | Install the matilha ecosystem (plugin + packs) |
init |
— | Bootstrap a matilha project (project-status.md, docs/matilha/) |
howl |
0 | Show current project phase + next action |
scout |
00→10 | Phase 00 discovery — map the problem space |
plan <slug> |
10→30 | Scaffold spec + implementation plan |
attest [gate] |
any | Validate and flip a phase gate |
plan-status |
any | Show feature artifacts + gate state |
hunt <slug> |
40 | Decompose plan into waves, create git worktrees |
gather <slug> |
40 | Merge completed SPs, run regression, update wave status |
list |
— | List skills in the matilha registry |
pull <slug> |
— | Pull a skill or resource from the registry |
Plugin ecosystem
The CLI is one of two install surfaces. The other is the Claude Code plugin:
| Surface | Install | Best for |
|---|---|---|
npm CLI (matilha) |
npm install -g matilha |
CI, scripts, headless automation, power users |
Plugin (matilha-skills) |
matilha install-plugins --deep or /matilha-install wizard |
Interactive development inside Claude Code |
Both share the same methodology content from danilods/matilha-skills.
Update
npm install -g matilha@latest
matilha --versionTo also update the Claude Code plugins (core + packs):
matilha install-plugins --full --deepThen in Claude Code: /reload-plugins.
Uninstall
# Remove the CLI
npm uninstall -g matilha
# Remove the Claude Code plugins
claude plugin uninstall matilha --scope user
claude plugin uninstall matilha-ux-pack --scope user
claude plugin uninstall matilha-growth-pack --scope user
claude plugin uninstall matilha-harness-pack --scope user
claude plugin uninstall matilha-sysdesign-pack --scope user
claude plugin uninstall matilha-software-eng-pack --scope user
claude plugin uninstall matilha-software-arch-pack --scope user
claude plugin uninstall matilha-security-pack --scope userOptional: remove the CLAUDE.md activation snippet — it sits between <!-- matilha-start v1 --> and <!-- matilha-end v1 --> markers.
Try locally
git clone https://github.com/danilods/matilha.git
cd matilha
npm install
npm run build
node dist/cli.js --helpLicense
MIT © Danilo de Sousa