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.
• Session restore — when cmux relaunches, Amp threads resume in place via amp threads continue <id>. The plugin auto-registers Amp as a custom vault agent in ~/.config/cmux/cmux.json and writes a hook-session record for each thread. Requires cmux nightly or ≥ 0.64.4 once released (custom vault registry support). Older cmux silently ignores the files.
  • Manual fallback: cmux: Register Amp for cmux session restore in the command palette.

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. 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.