A local-first AI coding agent for VS Code with repository-aware context, controlled execution, and flexible model providers.

AI coding agent · VS Code · local-first · MCP · Ollama · TypeScript

Mitii understands a repository before it changes it. It combines local indexing, Ask/Plan/Agent workflows, approval-aware tools, checkpoints, memory, and audit logs in one VS Code experience. Use a local model for privacy or connect a supported cloud provider when more capability is required.

• Repository-aware context — SQLite FTS5, symbols, vectors, repo maps, diagnostics, Git state, and explicitly attached files.
• Clear operating modes — Ask for read-only analysis, Plan complex work, Agent applies changes, and Review inspects results.
• Controlled execution — configurable approvals, dangerous-command blocking, workspace trust checks, and pre-write checkpoints.
• Model flexibility — Ollama, LM Studio, OpenAI-compatible APIs, OpenRouter, OpenAI, Azure OpenAI, Bedrock, Anthropic, Gemini, DeepSeek, and test providers.
• Extensible workflows — built-in tools, MCP servers, project rules, reusable skills, typed subagents, and GitHub issue context.
• Enterprise evidence — local session logs, redacted audit packs, provider boundaries, managed settings, and optional SIEM webhooks.

flowchart LR
  User[Developer] --> UI[VS Code webview]
  UI --> Controller[Runtime controller]
  Controller --> Context[Hybrid context engine]
  Context --> Index[(SQLite FTS5 + symbols)]
  Context --> Vectors[(LanceDB or SQLite vectors)]
  Controller --> Pipeline[Classify → route → depth → skills]
  Pipeline --> Loop[Ask / Plan / Agent loop]
  Loop --> Policy[Tool policy + approvals]
  Policy --> Tools[Files, shell, Git, MCP]
  Loop --> State[(Plans, memory, logs, checkpoints)]
  Loop --> Provider[Local or cloud model]

The extension can run the engine in-process or connect to the HTTP/SSE daemon. The CLI and @mitii/sdk use the same headless event model. See ARCHITECTURE.md for component boundaries, request flows, storage, security, and an end-to-end example.

• VS Code 1.85 or newer
• Node.js 20 or newer
• pnpm 10.13 or newer for source development

git clone https://github.com/Mitii-dev/Mitii.git
cd Mitii
pnpm run setup

Press F5 in VS Code to open an Extension Development Host. Open a project, select the Mitii icon, wait for indexing to complete, and choose a provider in Settings.

For Cursor development on macOS:

pnpm run setup:cursor

Run an OpenAI-compatible endpoint such as Ollama, then configure:

{
  "mitii.provider.type": "openai-compatible",
  "mitii.provider.baseUrl": "http://localhost:11434/v1",
  "mitii.provider.model": "qwen3-coder:30b",
  "mitii.safety.autonomyPreset": "guided",
  "mitii.safety.approvalMode": "review_all"
}

API keys for hosted providers are stored in VS Code SecretStorage rather than workspace settings.

Ask Mitii:

Plan a safe migration of the user cache to Redis. Identify affected files,
tests, rollback steps, and configuration changes. Do not edit files yet.

Review the generated plan, switch to Agent mode, and send:

Implement the approved plan and run the relevant tests.

Mitii retrieves relevant context, selects the required capabilities, requests approval for protected actions, checkpoints affected files, applies scoped edits, and runs configured or discovered verification commands.

Start the shared daemon:

mitii serve --cwd /path/to/project
curl http://127.0.0.1:4310/health

Install and import the Node SDK:

npm install @mitii/sdk

import { query } from '@mitii/sdk';

for await (const event of query({
  cwd: process.cwd(),
  prompt: 'Summarize the authentication flow',
  mode: 'ask',
  provider: 'openai-compatible',
  baseUrl: 'http://localhost:11434/v1',
  model: 'qwen3-coder:30b',
  allowNetwork: false,
})) {
  if (event.type === 'assistant_delta') process.stdout.write(event.content);
}

Use DaemonClient from @mitii/sdk/daemon for persistent sessions, replayable SSE events, approvals, and cancellation. More examples are in packages/sdk/README.md and packages/cli/README.md.

Mitii keeps indexes, plans, memory, logs, and checkpoints local by default. Only context sent to the configured model provider crosses that provider boundary.

Key controls include:

• local-provider enforcement with mitii.enterprise.localProvidersOnly
• approval presets and workspace trust enforcement
• redacted, hash-verifiable audit pack exports
• optional removal of file contents from audit exports
• optional signed SIEM/webhook delivery
• policy switches for channels, remote writes, and parallel sessions

Security, compliance, procurement, and deployment guidance is available in docs/enterprise.

mitii-ai-agent/
├── src/
│   ├── extension.ts          # VS Code entry point
│   ├── core/                 # runtime, context, safety, tools, providers
│   ├── vscode/               # editor adapters and webview bridge
│   ├── webview-ui/           # React sidebar
│   └── node/                 # CLI entry point and VS Code shim
├── packages/
│   ├── sdk/                  # @mitii/sdk
│   ├── daemon/               # HTTP/SSE runtime
│   ├── cli/                  # platform launcher
│   ├── channels/             # external channel adapters
│   └── board/                # parallel-agent task board
├── tools/benchmark/          # benchmark and evaluation harness
├── docs/                     # user, developer, and enterprise guides
├── test/                     # Vitest suite
└── scripts/                  # build, release, and audit automation

pnpm run watch              # extension and webview watch builds
pnpm run lint               # TypeScript validation
pnpm test                   # full Vitest suite
pnpm run smoke              # smoke tests
pnpm run package            # build the VSIX
pnpm run package:preflight  # release checks, tests, and package

Native modules target different runtimes:

pnpm run rebuild:native     # VS Code/Electron
pnpm run rebuild:node       # local Node.js tests

See CONTRIBUTING.md for coding conventions and pull request guidance.

• Architecture
• User and developer guides
• Enterprise pack
• Benchmark harness
• Website
• Hosted documentation

Contributions are welcome. Keep changes focused and run pnpm run lint and pnpm test before opening a pull request.

• Issues: github.com/Mitii-dev/Mitii/issues
• Author: @codewithshinde
• Email: [email protected]

Mitii AI Agent is licensed under AGPL-3.0-or-later. Contact the maintainer for commercial licensing outside the AGPL terms.