Introduction

Mia (Minimal Intelligent Agent) is a mobile-first AI coding assistant. It runs as a background daemon on your machine, pairs with your phone over encrypted P2P networking, and delegates coding tasks to pluggable AI agents. No cloud servers. No intermediaries. Just your phone talking directly to your dev machine.

Core Philosophy

• Mobile-first — The Mia mobile app is the primary interface. Chat with your AI assistant, switch agents, manage personas, and monitor tasks — all from your phone.
• Local-first — Everything runs on your machine. No intermediary servers. Your code never leaves your network unless you send it to an AI provider.
• Token-efficient — Context is carefully budgeted and cached. You don’t pay for redundant tokens.
• Modular — Swap AI backends without changing your workflow. Claude Code today, Gemini tomorrow.
• Privacy-respecting — P2P sync uses Hyperswarm DHT with no central relay. Memory is stored in local SQLite.

What Can Mia Do?

Mobile Access (Primary)

Pair your phone via QR code and control your AI coding assistant from anywhere. The mobile app supports:

• Real-time streaming AI conversations
• Switching between coding agents
• Creating and managing AI personas
• Scheduling automated tasks
• Searching memory and conversations
• Slash commands (/standup, /doctor, /usage, /memory, etc.)

mia p2p qr          # Show pairing QR code — scan with the Mia app

Interactive Coding

Start a multi-turn conversation with your AI. Mia automatically injects workspace context, git state, and relevant memory facts.

mia chat

One-Shot Tasks

Ask a single question and get an answer. Pipe in context from other commands.

mia ask "Explain the auth flow in this project"
git diff --staged | mia ask "Write a commit message for this"

Workflow Automation

Generate commit messages, standup reports, and changelogs from your git history.

mia commit          # AI-generated commit message
mia standup         # Summary of recent work
mia changelog       # Changelog from git history

Scheduled Tasks

Set up cron-based tasks that run automatically — daily standups, weekly summaries, whatever you need. Manage them from the mobile app or CLI.

mia scheduler add "0 9 * * MON" "Write a weekly summary"

Architecture at a Glance

┌──────────────────────────────────────────────┐
│              USER INTERFACES                 │
│  Mobile App (primary)  ·  CLI  ·  P2P       │
└────────────────────┬─────────────────────────┘
                     │
┌────────────────────▼─────────────────────────┐
│              DAEMON CORE                     │
│  Process lifecycle · Message routing         │
│  Plugin dispatch · Middleware chain           │
└──┬─────┬──────────┬──────────┬──────┬────────┘
   │     │          │          │      │
   ▼     ▼          ▼          ▼      ▼
Plugins  P2P     Memory    Context  Scheduler

Tech Stack

Layer	Technology
Language	TypeScript (strict, ESM)
Runtime	Node.js 18+
CLI	@clack/prompts
Build	esbuild + tsc
Test	Vitest
AI Backends	Anthropic, Gemini, OpenAI, OpenCode
P2P	Hyperswarm + HyperDB
Database	SQLite (FTS5)
Scheduling	node-cron
Logging	pino