5745
Sc
sacenox.github.io / files
sacenox.github.io / _posts / 2026-02-25-meet-mini-coder.md
3.2 KB
1--- 2layout: post 3title: meet-mini-coder-the-pocket-knife-of-ai-coding-agents 4description: Mini-coder is a CLI coding agent that lives in your terminal — fast, minimal, and built by an agent itself. 5--- 6 7# Meet Mini-Coder: The Pocket Knife of AI Coding Agents 8 9I've been using AI coding tools for a while now, and most of them feel like they were designed by someone who's never actually been in the zone. Heavy GUIs, slow startups, a dozen config files before you write a single line of code. Mini-coder is the opposite of all that. 10 11## What Is It? 12 13Mini-coder (`mc`) is a CLI coding agent that lives in your terminal. You run `mc`, type a prompt, and it gets to work — reading files, searching code, making edits, running shell commands. It talks to whatever LLM you've got handy: Anthropic, OpenAI, Google, a local Ollama model, or Zen. It auto-discovers your API keys from environment variables, so there's no special setup dance. 14 15The whole thing runs on [Bun.js](https://bun.com), which means fast startup and native TypeScript. Your sessions are saved in a local SQLite file, so you can pick up where you left off with `-c` or jump back to a specific conversation with `-r <id>`. 16 17## The Tools It Has 18 19Mini-coder gives the LLM a tight, reliable set of tools: `glob`, `grep`, `read`, `create`, `replace`, `insert`, `shell`, and `subagent`. That last one is my favorite — it can spawn parallel copies of itself to tackle independent subtasks at the same time. Divide and conquer, with AI. 20 21The `replace` and `insert` tools use hashline anchors (line numbers + a short hash) so edits land exactly where they should. No more "replace all occurrences and hope for the best." 22 23## The Little Things That Matter 24 25The slash commands are genuinely useful. `/plan` puts it in read-only thinking mode so it can reason without touching anything. `/ralph` kicks off an autonomous loop. `/review` spins up a subagent focused purely on code review. `/undo` rolls back the last turn if it went sideways. 26 27There's also a `.agents` folder convention for custom commands, agents, and skills — and it's the same convention used by Claude Code, Opencode, and other tools in the ecosystem. Write a skill once, use it everywhere. 28 29One detail I love: it only uses the 16 standard ANSI colors. That means its output inherits your terminal theme automatically. Dark mode, light mode, Gruvbox, Solarized — it just looks right, every time. 30 31And yes, mini-coder was built *by* a mini-coder agent. Agents all the way down. 🐢 32 33## The Takeaway 34 35Mini-coder isn't trying to replace your IDE or become the center of your workflow. It wants to disappear into it. If you're the kind of developer who lives in the terminal and gets annoyed when tools get in the way, `mc` is worth a try. Install it with `bun add -g mini-coder` and you're off. 36 37--- 38 39## Sources 40 41- [mini-coder README](https://github.com/sacenox/mini-coder) — local repo `README.md` 42- [mini-coder idea doc](https://github.com/sacenox/mini-coder/blob/main/mini-coder-idea.md) — local repo `mini-coder-idea.md` 43- [Bun.js](https://bun.com) 44- [AI SDK](https://ai-sdk.dev) 45- [yoctocolors](https://github.com/sindresorhus/yoctocolors) 46- [.agents convention](https://github.com/agentsmd/agents.md)