MINMODE
The engine that runs on what you already have.
A named crew of AI agents plans, builds, and reviews your software, running on the Claude or ChatGPT subscription you already pay for. No API keys, no metered billing. Every decision lands as a file you can read, and nothing ships without you.
built by Doguhan Uluca, author of Angular for Enterprise Applications · three editions
curl -fsSL https://minmode.dev/install.sh | sh
iex (irm https://minmode.dev/install.ps1)
Free · Apache-2.0 · no API key · runs offline · macOS / Windows / Linux
no new bill
The subscriptions you already pay for
Phases run through the agent CLIs already signed in on your machine. Minmode shells out to Claude Code, Codex, or Gemini CLI, and each carries its own login, so the work runs on your existing Claude, ChatGPT, or Google plan with no API key in the mix. An Anthropic key works when you want metered billing, and any OpenAI-compatible server keeps everything on your own metal.
MINMODE_PROVIDER=claude-cli
MINMODE_PROVIDER=codex-cli
MINMODE_PROVIDER=gemini-cli
MINMODE_PROVIDER=openai-compatible
Roles can split across services, so one vendor’s model doesn’t grade its own homework:
The installer meets you halfway, too: when it finds Claude Code on the machine, it
offers to put the crew’s skills into ~/.claude/skills. One
question, one keystroke.
add a node
The hardware you already own
The router is local-first by default: it measures what your machine can carry and
serves those tiers from local models, with the cloud as the fallback.
MINMODE_BACKEND=local pins it home entirely. The run halts rather
than quietly spending.
The strongest GPU you own is probably not in the laptop you code on. Register the machine it lives in as a compute node: heavy tiers route to it over mutual TLS, and the decision artifact records which machine served each call. On a shared network that takes one command; across networks, the bundled tunnel sidecar crosses NAT with a token file.
Your gaming PC finally has a day job.
the product
A team room you can leave open
This is the product: agents work, decisions and halts land as files on disk, and the room shows who is doing what right now.
Vignette rendered in HTML. The real app looks like this because it shares this design system.
the crew
Meet the crew
Eight roles work the plan. Each has a name, a job description, and a sign-off gate to clear before the plan moves. The Claude Code plugin ships 14 persona subagents and 12 role skills. Hover a teammate to see them get to work.
Doguhan, the reviewer from the note above, holds no phase. He reads over everyone’s shoulder and files review notes. Specialists like the Architect and SRE join when triage calls for them.
the discipline
Plan. Run. Halt, then ship.
Plan
Open an Engagement Plan: a markdown artifact with scope, acceptance criteria, and phase gates. Triage picks the minimum crew for the job.
Run
The orchestrator drives the plan through eight phases. Every routing call, feasibility judgment, and quality gate is committed as a decision artifact before it takes effect. Your decisions become documentation.
Halt, then ship
Guardrails are typed halt conditions: out-of-scope edits, failed verification, security boundaries. When one trips, the runtime stops, writes a halt file, and waits for you. Resume with one command, from the room or the terminal.
The name comes from Shu-Ha-Ri, the martial-arts ladder: learn the form, adapt the form, transcend the form. Minmode is shu. Run the discipline as given first; skip that step and you adapt the wrong thing.
from the author
Doguhan pops in
Hi, I’m Doguhan. Three editions of Angular for Enterprise Applications went into one argument: discipline is what lets a small crew ship big software. Router-first architecture, walking skeletons, decisions written down where everyone can read them. Minmode hands that playbook to a crew of agents, and the roles and skills on this page come straight out of it.
I’m in the crew, too. Every engagement ships with a principal reviewer named Doguhan who pops in every few phases, reads the whole engagement, and leaves a review note. He can’t halt your run, and he won’t stay quiet about drift. That’s the reviewer I try to be, so I put him in.
What you install here is what I ship with every day: minmode’s own repository is planned, built, and reviewed by its crew, and the engagement plans sit in the repo for anyone to read.
— Doguhan Uluca · angularforenterprise.com · ExpertlySimple
start now
Three commands to a running room
minmode statuswhere every plan standsminmode why D-0142the paper trail behind any decisionminmode resume EP-0007 --input "ship it"answer a halt without leaving the terminalminmode ask "where is the fetch layer?"read-only answers about the repo in front of youFree, Apache-2.0. No account, no telemetry. The default provider is a deterministic stub, so the engine runs before you wire up any model or key.