cmux-amp

Amp plugin for cmux that turns your cmux tab into a live dashboard for the Amp agent.

Built on the Amp Plugin API introduced with Amp Neo. The plugin API is experimental and subject to change.

• Live status badge in the cmux tab switcher — idle → thinking → running: yarn test / editing: cmux-status.ts / reading: README.md → done / error / interrupted. Tool labels include the actual shell command being run, the file being edited, the search pattern, etc., powered by the Neo plugin helpers (shellCommandFromToolCall, filesModifiedByToolCall).
• Workspace title tracks the Amp thread ID, including a chain of any threads spawned via handoff. Manual renames are detected and preserved across agent restarts.
• cmux activity log entries for prompt received, tool errors, spawned threads, and turn outcomes.
• cmux_notify tool the agent can call to fire a native macOS notification when it needs your attention.
• Command palette actions under the cmux: category:
  • Rename workspace to thread ID
  • Rename workspace… (prompts for a new title)
  • Clear Amp status
• Macro notification when an agent turn ends with an error.

1. Symlink (or copy) plugin/cmux-status.ts into your plugins directory:
   • System: ~/.config/amp/plugins/cmux-status.ts
   • Project: <repo>/.amp/plugins/cmux-status.ts
2. Run Amp with plugins enabled: PLUGINS=all amp (or set PLUGINS=all in your shell profile).
3. Launch amp from inside a cmux workspace.

Plugins only work when the Amp CLI is installed via the binary install method (not npm install). See the Amp Plugin API docs for details.