mint

 ███╗   ███╗██╗███╗   ██╗████████╗
 ████╗ ████║██║████╗  ██║╚══██╔══╝
 ██╔████╔██║██║██╔██╗ ██║   ██║
 ██║╚██╔╝██║██║██║╚██╗██║   ██║
 ██║ ╚═╝ ██║██║██║ ╚████║   ██║
 ╚═╝     ╚═╝╚═╝╚═╝  ╚═══╝   ╚═╝

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/<session-id>/<slug>/ — per-session spec XMLs + execution.json + pipeline-state.json
├── .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