Skip to content

miao

miao is an open-source AI agent for the terminal. It helps you write code, research topics, manage files and automate tasks, using the models you choose. It focuses on the engineering around the model: durable sessions, context efficiency, delegation and a visible cost per turn.

Run it inside mtty for per-pane agent status, input notifications and queued prompts.

Terminal window
curl -fsSL https://mtty.dev/miao/install | bash
Why choose miao? Use cases, current features and limits, and development direction
Guide Install and upgrade, providers, configuration, keybindings, sessions and models, commands and skills, MCP, LSP, the sandbox, cost telemetry, the autonomous loop, FAQ and troubleshooting
Command reference Every CLI subcommand, TUI slash command and common environment variable, with what each one does
FAQ Common questions about install, providers, permissions, configuration, data and troubleshooting
Providers and models Connect providers, choose and price models, custom providers and where the catalog comes from
Remote Control Connect a window to your Hub, pair a device, manage scoped access and understand its lifecycle
Versioning and release How versions are numbered, built and published, and how to roll back
Agent workflow comparison Eight open-source agents: parallel tools, long work, context and recovery, with source evidence
Native component benchmarks Recorded internal timings and native/sandbox scope, separate from product comparisons
Contributing Reporting a problem and sending a change
Security How to report a vulnerability

Source, issues and releases: mttydev/miao.

miao is derived from opencode, whose MIT-licensed code provides a substantial part of the project. Thanks to its authors and contributors. miao has its own maintenance and releases; the source relationship does not imply affiliation or endorsement.

See project origins and licensing for the preserved copyright notices and redistribution terms.