Miton

For Developers

Code without context-switching.

Miton is a chat-first agentic IDE for engineers who ship real software but don't want to live in five tools. You describe what you're building. Miton plans, codes, tests, and runs it. You stay in flow.

Get the source See why Miton →

This page is the developer lens. For the maker lens see landing_for_makers.md, the writer lens see landing_for_writers.md, the power-user lens see landing_for_power_users.md. Same engine. Four lenses. One chat.

Why Miton Over Cursor / Windsurf / Replit

Architecture

Agent loop
  ├── Model routing           → picks the best model per task
  ├── Token optimisation      → caching, condensation, compression
  ├── Codebase search         → grep + semantic hybrid
  ├── Knowledge index         → blueprint, milestones, drift
  ├── Sub-agents              → isolated, worktree-scoped
  ├── Skills                  → slash-command invocable
  └── MCP (external tools)    → connect any MCP server

Surfaces (lenses over the same engine):
  ├── Canvas                  → visual no-code builder
  ├── Project                 → code editor + file tree
  ├── Workflow                → visual automation builder
  └── Document                → long-form writing

The full system map — including the engine’s internal subsystem names — lives in docs/system_architecture.md and docs/glossary.md. Greek subsystem names are the engine’s internal vocabulary, not user vocabulary. Per ADR-0032, they do not appear in any user-visible surface.

Quick Start

git clone https://github.com/foundryseven/miton.git
cd miton
pnpm install
pnpm dev

Prerequisites: Node 20+, pnpm 9+, Rust 1.74+, Xcode CLT (macOS).

Key Features for Developers

Five routing profiles:

Sub-agents in worktrees:

/daemon spawn fix-the-login-bug
# Miton creates a worktree, spawns an isolated agent, reports back when done

Skills:

/review    # code review
/scan      # security scan
/docs      # generate documentation
/deploy    # deployment pipeline
/debug     # systematic debugging

Milestones:

## Milestone: v0.4 Auth

- [x] Set up Express
- [x] Add user model
- [x] Login endpoint
- [ ] Password reset ← agent works on this next

MCP support:

// ~/.config/miton/mcp.json
{
  "servers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "..."]
    },
    "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"] }
  }
}

Pricing

The on-disk source is source-available under the Functional Source License, Version 1.1, with an Apache 2.0 Change Date of 2028-06-12. See LICENSE and docs/LICENSING.md.

Roadmap

Miton is in active pre-release (Phase 1.7 in progress as of 2026-06-19). The chat, the model layer, the four-lens surface system, sub-agents in git worktrees, skills, the free multi-provider gateway, and the local-first guarantees are all wired and shipping in the current pre-release build. Provider & Models panel, the rich model dashboard, and paid-plan referral are the last blockers before a v0.x → v1.0 cut.

The full live status — Shipped / In flight / Planned — is on the public roadmap. Engineering detail is in docs/active_context.md and docs/implementation_tracker.md.

Recent shipped phases:

Contributing

# Read the project instructions first
cat MITON.md

# Check what's being worked on
cat docs/active_context.md

# Pick a task from the tracker
cat docs/implementation_tracker.md

AU English spelling. TypeScript strict mode. No any. Co-located tests. Run pnpm lint && pnpm typecheck after every change.

See CONTRIBUTING.md for the full guide, and docs/marketing/voice.md for the public-facing brand voice.