Muse Code plugin for Claude Code

# Muse Code plugin for Claude Code

Use Meta's [Muse Code](https://developer.meta.com/ai/products/muse-code/) from inside Claude Code: ask it for a review, hand it a task, or move a Claude session over to it.

Reviews and delegated work run as background jobs you can check on, stop, or resume, so a long Muse run does not hold up the Claude session that started it.

![Animated transcript of /muse:check, /muse:review, /muse:delegate --worktree, --resume, background runs, /muse:stop and /muse:transfer against Muse Code 1.3](docs/demo.svg)

<sub>The demo is one real session against Muse Code 1.3.0, captured command by command into `docs/demo-captures/`. The repository path and home directory are substituted when the demo is built, and the login email is redacted in the capture files. `npm run build-demo-script` turns the captures into `docs/demo-script.json` and `npm run render-demo` draws it.</sub>

Everything these commands send (diffs, prompts, transcripts) goes to Meta's hosted model through your Muse login, the same as when you run Muse yourself.

## Commands

- `/muse:review`: read-only review of your working tree or branch
- `/muse:critique`: a harsher review of the design, with findings returned as structured JSON
- `/muse:delegate`: hand a task to Muse through the `muse:muse-delegate` subagent, which Claude may also reach for on its own when a debugging or implementation job is large
- `/muse:transfer`: continue the current Claude session in Muse
- `/muse:runs`, `/muse:show`, `/muse:stop`: background runs
- `/muse:check`: setup check; also switches the stop-time review gate on or off
- `/muse:sync-skills`: import your Claude Code skills into Muse

Some of this comes straight from Muse rather than from the bridge: `--worktree` delegation, `--image` attachments, and critique findings that Muse enforces with `--output-schema`. Session transfer uses Muse's bundled `resume-claude` skill.

## Requirements

- Muse Code, installed and logged in (`muse login` or `META_API_KEY`). Runs count against your Muse usage.
- Node.js 20 or later on the machine running Claude Code (CI runs 20 and 22).
- Git on `PATH`.

Muse installs with `curl https://dev.meta.ai/install.sh | bash` on macOS and Linux, or `irm https://dev.meta.ai/install.ps1 | iex` on Windows. The plugin runs `muse` where Claude Code runs; if you keep Muse inside WSL, run Claude Code there too (see [Windows