# captain-miao: Monitor and Manage AI Coding Sessions in Your Terminal This repository profile is provided by osrepos.com, an open source repository discovery platform. Source: osrepos.com Repository profile: https://osrepos.com/repo/hyperlogue-captain-miao Generated for open source discovery and AI-assisted research. A Rust-based mission-control dashboard for AI coding sessions in terminal windows, tabs, and panes. Track sessions that need attention, jump to them, and keep remote sessions running across disconnects. GitHub: https://github.com/hyperlogue/captain-miao OSRepos URL: https://osrepos.com/repo/hyperlogue-captain-miao ## Summary A Rust-based mission-control dashboard for AI coding sessions in terminal windows, tabs, and panes. Track sessions that need attention, jump to them, and keep remote sessions running across disconnects. ## Topics - rust - terminal - ai-agents - dashboard - coding-agent-dashboard - terminal-session-manager - remote-agent-sessions ## Repository Information Last analyzed by OSRepos: Wed Oct 28 2026 21:20:26 GMT+0000 (Western European Standard Time) Detail views: 2 GitHub clicks: 0 ## Safety Notice OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything. ## Content ## Overview captain-miao is a Rust-based mission-control dashboard for AI coding sessions in terminal. It brings sessions from supported agents into one view, highlights the ones that need attention, and lets you jump to their native terminal windows, tabs, or panes. It supports Kitty and zellij, with additional support for tmux, Ghostty, and iTerm2 on the platforms described in the [README](https://github.com/hyperlogue/captain-miao#readme). For remote work, its `miao-server` runs agents in a shpool pty pool on an SSH host, so sessions can continue when your computer sleeps or the network disconnects. It is aimed at developers who run multiple coding agents and want to keep their existing terminal setup rather than move sessions into a separate interface. ## Key Features - Shows sessions from supported coding agents in a single dashboard and highlights those requiring attention. - Focuses the selected session's terminal window or pane, and provides controls to start, resume, fork, or stop sessions. - Integrates with agents including Claude Code, Codex, Grok Build, Antigravity, Reasonix, Kimi Code, opencode, Pi, and oh-my-pi, with varying support levels. - Supports persistent remote sessions through `miao-server` and SSH, with reconnection after a disconnect. - Uses isolated tracking hooks and integration files for managed sessions rather than changing specified global Claude Code and Codex settings. - Offers transcript or screen previews where supported, with preview capabilities varying by terminal. ## Use Cases - A developer running several coding agents can spot which session needs input and switch directly to its terminal. - A team member working over SSH can leave an agent running on a remote host and reconnect after a laptop sleeps or loses network access. - Someone who prefers terminal-native workflows can manage agent sessions without replacing their terminal's windows, tabs, panes, fonts, or key bindings. - Developers experimenting with different coding agents can view sessions from several supported tools in one dashboard, while accounting for uneven integration support. ## Our Take captain-miao is a promising, actively changing terminal dashboard, but its fast development and highly concentrated contributor base are worth weighing before relying on it for essential workflows. **Good fit if:** - You run multiple supported coding agents in Kitty or zellij and want a shared session overview. - You need remote agent sessions to persist across local sleep or network loss. - You are comfortable adopting a young project: it has recent commits and releases, but nearly all contribution activity is concentrated in one of its four contributors. **Look elsewhere if:** - Your required agent or terminal depends on a capability that is not stable or is explicitly unsupported, such as worktree support in some integrations. - You need a mature project with broadly distributed maintenance; the project is less than six months old and contribution activity is highly concentrated. - You need identical transcript previews or session controls across terminals, since the README documents terminal-specific limitations. ## Project Health | Signal | Value | |---|---| | Status | **New**: less than six months old and changing fast | | Last commit | 2026-10-28 (today) | | Commits, last 90 days | 100+ | | Releases, last 12 months | 19 (latest v0.15.0, 2026-10-18) | | Contributors | 4 (top contributor: 99% of commits) | | Issues closed, last 90 days | 1 | | Pull requests merged, last 90 days | 6 (typically merged in 1 day) | | Project age | 6 months | Checked on 2026-10-28 with the GitHub API. ## Project Facts - Language: Rust - License: MIT - Stars: 45 - Forks: 5 - Topics: claude-code, codex, ghostty, grok-build, iterm2, kimicode, kitty-terminal, oh-my-pi - Archived: no ## What You Need Detected in the repository: - Rust 1.95 or newer (from Cargo.toml) - Automated checks on GitHub Actions ## Getting Started Install the package and start the dashboard from a project directory: ```sh npm install -g @hyperlogue/captain-miao cd /path/to/your/project miao ``` Configure a supported terminal first. See the [README](https://github.com/hyperlogue/captain-miao#readme) for terminal setup, supported-agent details, remote sessions, and key bindings. ## License in Plain Words **MIT** (permissive). - Commercial use: yes - Modify and redistribute: yes - You must keep: the copyright and license notice - Share your changes: no A summary, not legal advice: the LICENSE file is what applies. ## Alternatives - [tmux-agent-sidebar](https://osrepos.com/repo/hiroppy-tmux-agent-sidebar): Focuses on a tmux sidebar with agent activity, Git details, and worktree controls, rather than cross-terminal session navigation and remote persistence. - [rimz](https://osrepos.com/repo/rimio-ai-rimz): Adds agent messaging, teams, worktrees, and automation across tmux and Zellij, while captain-miao focuses on session attention and navigation. | Project | Language | License | Stars | Status | |---|---|---|---|---| | **captain-miao** | Rust | MIT | 45 | New | | [tmux-agent-sidebar](https://osrepos.com/repo/hiroppy-tmux-agent-sidebar) | Rust | MIT | 553 | Active | | [rimz](https://osrepos.com/repo/rimio-ai-rimz) | Rust | MIT | 33 | New | ## Considerations - This is a new project that is changing quickly. Recent commit and release activity is high, but nearly all contribution activity comes from one person, which creates maintainer-concentration risk. - Integrations are not equivalent: the README marks only some agent and terminal integrations as stable and documents missing capabilities, including limited worktree support and varying preview behavior. - Remote persistence requires configuring an SSH host and `miao-server`; local session management also depends on a supported terminal integration. - The repository is MIT-licensed. Review the [license](https://github.com/hyperlogue/captain-miao/blob/main/LICENSE) when incorporating it into a product.