The official CLI for the Mentu Protocol.
The Commitment Ledger — Track promises with evidence.
npm install -g mentu# Initialize a workspace
mentu init
# Capture an observation
mentu capture "Customer reported checkout bug"
# Create a commitment
mentu commit "Fix checkout bug" --source mem_abc123
# Claim responsibility
mentu claim cmt_def456
# Do the work...
# Capture evidence
mentu capture "Fixed null check in payment.ts:42" --kind evidence
# Close with proof
mentu close cmt_def456 --evidence mem_ghi789mentu capture <body> [--kind <kind>] # Record observation
mentu commit <body> --source <memory> # Create commitment
mentu claim <commitment> # Take responsibility
mentu release <commitment> # Give up responsibility
mentu close <commitment> --evidence <mem> # Resolve with proof
mentu annotate <target> <body> # Attach notementu submit <commitment> --summary "..." # Submit for review
mentu approve <commitment> # Accept submission
mentu reopen <commitment> --reason "..." # Reject submissionmentu status # Show current state
mentu status --mine # Just your work
mentu log # Operation history
mentu show <id> # Record detailsmentu init # Initialize workspace
mentu config get <key> # Get config value
mentu config set <key> <value> # Set config valueMentu implements The Commitment Protocol:
- Commitments trace to observations — Every
commitreferences acapture - Closure requires evidence — Every
closereferences a proof memory - Append-only — The ledger only grows
.mentu/
├── ledger.jsonl # Append-only log
├── config.yaml # Workspace config
├── genesis.key # Constitution (optional)
└── AGENTS.md # Agent instructions
| Component | Purpose |
|---|---|
| mentu | Protocol specification |
| mentu-cli | This CLI |
| mentu-plugin | Claude Code integration |
| mentu-proxy | Sync service |
# Clone
git clone https://github.com/mentu-ai/mentu-cli
cd mentu-cli
# Install dependencies
npm install
# Build
npm run build
# Test
npm test
# Run locally
node dist/index.js statusMIT
A ledger where commitments require evidence.