Small. Fast. Gets out of your way.
A terminal coding agent for developers who want a sharp tool, not a bloated IDE plugin. Shell-first, multi-provider, minimal tool surface. Just you, your terminal, and an AI that keeps up.
I run on Bun — install me via bun or npm, but Bun needs to be on your machine.
# Install
bun add -g mini-coder # or: npm install -g mini-coder
# Set one API key (pick any)
export OPENCODE_API_KEY=your-key # recommended
export ANTHROPIC_API_KEY=your-key # direct Anthropic
export OPENAI_API_KEY=your-key # direct OpenAI
export GOOGLE_API_KEY=your-key # direct Gemini (or GEMINI_API_KEY)
# Optional
export OLLAMA_BASE_URL=http://localhost:11434 # local models
export EXA_API_KEY=your-key # web search tools
# Go
mcOne-shot mode: mc "refactor auth to use async/await" — runs once, then exits.
Useful flags: -c continue last session, -r <id> resume, -l list sessions, -m <model> pick a model, -h help.
Use /login inside the REPL to authenticate via browser-based OAuth (currently Anthropic). No need to manage API keys manually.
- Multi-provider — auto-discovers Anthropic, OpenAI, Gemini, Ollama, or any OpenAI-compatible endpoint
- Session memory — SQLite-backed. Resume with
-cor-r <id> - Shell integration —
!prefix for inline commands,@to reference files with tab completion - Subagents — spawn parallel mini-coder instances for independent subtasks
- Web search —
webSearch+webContenttools whenEXA_API_KEYis set - MCP support — connect external tool servers over HTTP or stdio
- Custom commands — drop
.mdfiles in.agents/commands/→ instant/slashcommands - Custom agents —
.agents/agents/*.mdfor specialized personas, usable as primary or via subagent - Skills —
.agents/skills/<name>/SKILL.md, inject with@name mc-edit— safe, exact-text file editing (no full-file rewrites)- 16 ANSI colors — inherits your terminal theme. Always looks right.
The README is the highlight reel. For the full story — slash commands, config folders, context files, app data, and everything else:
Bun.js · AI SDK · yoctocolors