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.
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.
Origins and license
Section titled “Origins and license”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.