Skip to content

remove plugin-side session restore + warn if cmux native bridge missing #12

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
comp615 wants to merge 5 commits into
base: main
Choose a base branch
from
+110 −214
Open

remove plugin-side session restore + warn if cmux native bridge missing #12

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
6c9f2a7
revert: remove plugin-side session restore
comp615 May 13, 2026
3362037
feat: warn when cmux native restore bridge plugin is missing
comp615 May 13, 2026
052fc05
feat: add rate-limited macOS notification when bridge plugin is missing
comp615 May 13, 2026
01473ac
feat: add `cmux: Install cmux session restore` command palette action
comp615 May 13, 2026
c9506b0
fix: pin cmux notifications to the current surface so they don't auto…
comp615 May 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 10 additions & 8 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,16 +27,18 @@ and subject to change.
- **Command palette actions** under the `cmux:` category:
- `Rename workspace to thread ID`
- `Rename workspace…` (prompts for a new title)
- `Install cmux session restore` (one-click `cmux hooks amp install`)
- `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](https://github.com/manaflow-ai/cmux/commit/744521d)
(custom vault registry support). Older cmux silently ignores the files.
- Manual fallback: `cmux: Register Amp for cmux session restore` in the
command palette.

> Session restore (resume Amp threads after a cmux relaunch) ships natively
> in cmux ≥ 0.64.5 — see
> [manaflow-ai/cmux#3710](https://github.com/manaflow-ai/cmux/pull/3710).
> Run `cmux hooks setup` (or `cmux hooks amp install`) to enable it. If the
> bridge plugin (`~/.config/amp/plugins/cmux-session.ts`) is missing, the
> plugin logs a warning to the cmux activity feed every session and
> additionally fires a native macOS notification at most once per 24h
> (state in `~/.cache/cmux-amp/bridge-warning.json`).

## Installation

Expand Down
Loading