███╗ ███╗██╗███╗ ██╗████████╗
████╗ ████║██║████╗ ██║╚══██╔══╝
██╔████╔██║██║██╔██╗ ██║ ██║
██║╚██╔╝██║██║██║╚██╗██║ ██║
██║ ╚═╝ ██║██║██║ ╚████║ ██║
╚═╝ ╚═╝╚═╝╚═╝ ╚═══╝ ╚═╝
Disciplined agentic development for Claude Code
Self-evolving skill architecture. Pipeline enforcement. Scored instincts. Zero slop.
Core philosophy: Slop is an engineering problem, not an LLM problem. If an agent produces bad code, fix the environment — never patch the output.
Install
curl -fsSL https://raw.githubusercontent.com/3li7alaki/mint/main/install.sh | bash
This installs the mint CLI globally and (if Claude Code is installed) the Claude plugin for auto-routing.
CLI
mint init # Claude reads your project, configures mint perfectly
mint init --yes # headless — auto-detect, no prompts (CI/scripts)
mint config # view current config
mint config --global # view global user defaults
mint config set key value # edit project config (dot notation, validated)
mint config set --global k v # set a global default
mint config list # show all available config keys with types and defaults
mint doctor # health check — static checks + tiered output
mint doctor --fix # health check + Claude applies context-aware fixes
mint update # update mint + Claude migrates ALL registered projects
mint clean # remove stale worktrees from parallel execution
Global Defaults
Set user preferences that apply to all projects:
mint config set --global autoCommit false
mint config set --global reviewers.security.model opus
mint config set --global isolation.plan worktree
Global config lives at ~/.mint/config.json. Project config always overrides global. Global config also tracks a project registry — every mint init registers the project, and mint update migrates all registered projects at once.
Project Setup
Run mint init in your project (seeds from global defaults if set):
.mint/
├── config.json — gates, reviewers, browser, design, plugins + mintVersion
├── hard-blocks.md — what agents can never do
├── issues.jsonl — failure log with root cause categories
├── wins.jsonl — success patterns
├── patterns.jsonl — graduated recurring patterns
├── instincts.jsonl — scored conventions (confidence, dedup, decay)
├── metrics.jsonl — per-spec execution metrics for evidence-based evolution
├── sessions/ — per-session state (gitignored, timestamp-prefixed IDs)
├── tasks/<slug>/ — spec XMLs + execution.json + pipeline-state.json per spec
├── .freeze-list.json — frozen/guarded paths (gitignored)
├── .browser-sessions.json — browser cookies (gitignored)
└── .gate-ledger.jsonl — gate run dedup (gitignored)
How It Works
You describe what you want. mint auto-detects the right approach:
| What you say | What mint does |
|---|
| Small fix, typo, config tweak | Quick — fixes directly, gates enforced |
| Feature, component, API route | Plan — decomposes into XML specs, executes atomically |
| Multiple features, batch of work | Ship — interviews you, plans phases, executes all |
| "Browse to", "scrape", "debug in browser" | Browse — PinchTab-powered browser automation |
| "How should I...", "Compare..." | Research — investigates, saves structured report |
| "Check quality", "Audit" | Verify — runs all gates and audits |
| "Dream", "Consolidate learning" | Dream — prunes instincts, triages issues, promotes patterns, health report |
| "Automate", "Detect workflows" | Automate — mine patterns, generate skills, graduate trust |
| "Design review", "Design profile" | Design — design intelligence commands |
| "Set up doc tracking" | Doc Setup — scans docs, maps sections to code, builds manifest |
| "Optimize my setup", "Am I using mint fully?" | Optimize — full audit of config, docs, workspace, agents, features |
/freeze src/auth/ | Freeze — blocks all file modifications under that path |
/guard package.json "no new deps" | Guard — freeze + reason shown to agents |
/unfreeze --all | Unfreeze — remove all freezes |
No commands to memorize. Just describe what you want to build.
The Pipeline
3li7alaki