All work

// open source

miii-cli

The open-source alternative to Claude Code. Any model, free forever.

Stack
TypeScript · Node ≥18 · Ink · 14+ providers
Status
v3.13.1 · 42★ · 56 releases · MIT
Install
npm i -g miii-agent

In plain words

A free AI helper for programmers. You tell it what to change; it writes the code, tests it, and fixes its own mistakes. It works with paid AI models, or with ones that run privately on your own computer.

Think
Developers want AI help, but often can't send private code to a cloud company or pay by the word.
Design
One small app for the terminal or browser, with a clear "may I?" before every risky step, so you stay in control.
Build
14+ AI providers, test-until-green with automatic rollback, a checkpoint at every step, and 56 public releases.
// 00 — The full story, for engineers

§ 01

The problem

Cloud coding agents are useful right up until you point them at proprietary code, or the bill arrives. Then you are shipping your source to a third party, juggling an account per vendor, and watching a per-token meter run. And you are locked to whichever model that vendor sells.

miii-cli answers two questions at once: can a genuinely capable coding agent run with nothing leaving the machine, and can the same agent use any model you choose when you do want the cloud?

§ 02

The decisions that mattered

  • Model-agnostic from the core. 14+ providers, Claude, GPT, Gemini, DeepSeek, Grok, Mistral, Kimi, GLM, Groq, OpenRouter, Cerebras, plus local runtimes (Ollama, LM Studio, llama.cpp, vLLM) for Qwen3 Coder, Devstral, gpt-oss and Llama. Bring your own key, or no key at all.
  • Fix-until-green with auto-rollback. The agent runs your tests, keeps iterating until they pass, and checkpoints so a bad turn can be rewound instead of hand-reverted.
  • `miii doctor` grades models on real agent tasks, so you pick a model by evidence, not by benchmark marketing.
  • Permission-gated edits and commands with persistent approval rules, because an agent that can run bash needs a real consent model, not a yes-to-everything prompt.
  • Path confinement and lossless output spill, so the agent stays inside the repo you handed it and never silently drops tool output.

§ 03

What it does

It reads code, plans, writes features, runs tests, and verifies its own work, from an Ink terminal UI or a browser app (`miii web`). MCP servers, hooks, and subagents extend it the same way the commercial agents do. `miii provider add anthropic` wires up Claude in one line; skip it and everything runs 100% offline.

Apna code, apna model, apni marzi. Your code, your model, your choice.

§ 04

Why it is on this page

It is the clearest statement of how I think about AI products: small surface, real safety model, no lock-in, no hand-waving about privacy. Fifty-six releases in, it is also proof I maintain what I ship.

Want this kind of thinking on your product?

Book a 20-min call