- Category
- Developer Tools
- Rank
- No. 1703Tools index
Previous survey · No. 1709 ·
- Pricing
- Open Source
- Type
- TOOL
- Builder
- block
- GitHub
- 4 stars
- Date
About
Show your Amp coding agent status inside cmux for a unified terminal multiplexer view.
What it does
Cmux Amp listens to Amp agent lifecycle and tool activity, then turns each workspace tab into an operational dashboard. It reports whether the agent is thinking, running commands, editing, reading, finished, interrupted, or failed. It also tracks thread chains in workspace titles, records key events, sends native attention alerts, exposes rename and cleanup actions, and prepares eligible sessions to resume after cmux relaunches.
Why it's ranked here
The plugin offers unusually specific visibility into unattended agent work, including actual commands, affected files, errors, and spawned threads. Session restoration and manual-rename preservation show careful attention to real workflows. However, most functionality now lives in cmux itself, so this plugin is mainly a compatibility fallback built against an experimental API.
What's good
Status labels describe concrete activity instead of showing a generic busy indicator. Updates follow a tab when it moves between workspaces, and a short cache limits repeated workspace lookups. User-assigned workspace names survive agent restarts. Activity logs, error notifications, command-palette controls, and thread resumption cover monitoring, intervention, and recovery without requiring constant terminal focus.
Tradeoffs
Installation is manual and only works with the binary distribution of the Amp CLI, not its npm installation. The underlying plugin API is explicitly experimental and may change. Session restoration needs a sufficiently recent cmux build, while older versions silently ignore its registration files. Many command failures are swallowed, which protects the agent session but can leave missing status or notifications unexplained.
How to use it well
Use it when you run Amp inside cmux, leave agents working across several tabs, and need fast context about activity, failures, or handoffs. Start with current cmux because its core already contains most features. Install this plugin only when that built-in support falls short. It monitors and coordinates Amp sessions; it does not supply coding-agent capabilities or replace Amp itself.
Technical notes+
The implementation is concentrated in plugin/cmux-status.ts, a TypeScript Amp Plugin API module that uses Bun’s shell for escaped arguments and full shell-promise behavior. It resolves the active workspace from CMUX_SURFACE_ID through cmux rpc system.tree, falls back to CMUX_WORKSPACE_ID, and caches results for 500 milliseconds. Helpers map Amp tools to labels, SF Symbols, colors, command details, and modified-file details. The source targets ~/.cmuxterm/amp-hook-sessions.json for restoration records and ~/.config/cmux/cmux.json for custom vault-agent registration. README.md documents installation by copying or symlinking the module into an Amp plugin directory.
Observed
- License
- Apache License 2.0
- Primary language
- TypeScript
- Packaging and installation
- Single Amp plugin copied or symlinked into a system or project plugin directory
- Required install surface
- Requires the binary installation of the Amp CLI; npm installation is unsupported
- Interfaces
- Amp Plugin API integration, cmux command-palette actions, and an agent-callable notification tool
- Platform support
- Native notifications target macOS; session restoration requires cmux nightly or custom vault registry support
- Repository structure
- The provided repository tree contains no test directory
Read from README.md, plugin/cmux-status.ts, LICENSE, CODEOWNERS, GOVERNANCE.md, renovate.json, .github/ISSUE_TEMPLATE/config.yml, .github/ISSUE_TEMPLATE/bug-report.md.
What it can do
Display Amp coding agent status
Amp coding agent process → Real-time status information
Integrate Amp status into terminal multiplexer
Amp agent and cmux session → Unified terminal view with Amp status
Monitor coding agent activity
Running Amp processes → Activity indicators and metrics
Provide unified terminal interface
Multiple terminal sessions and Amp status → Single consolidated terminal view
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.