Muse CLI Chat for VS Code and Cursor

# Muse CLI Chat (unofficial)

### [Inception: A Muse Inside Muse](https://blog.codemarc.net/inception-a-muse-inside-muse)

VS Code / Cursor sidebar chat that drives Meta’s **Muse Code** CLI (`muse exec --json`). The agent harness stays Muse; this extension is only the IDE UI.

**Not affiliated with Meta.** Muse Code, Muse Spark, and related marks belong to Meta. Install and authenticate Muse separately: [Muse Code docs](https://dev.meta.ai/docs/muse-code).

Privacy and security: [PRIVACY.md](./PRIVACY.md) · [SECURITY.md](./SECURITY.md)

## Requirements

- macOS or Linux (Muse Code CLI does not support Windows yet)
- [Muse Code](https://dev.meta.ai/docs/muse-code) installed and signed in (or `META_API_KEY` set)
- VS Code or Cursor
- An open workspace **folder** that is not a symlink root (Muse rejects reparse points)

```bash
curl -fsSL https://dev.meta.ai/install.sh | sh
muse login
# or: export META_API_KEY=...   # must be visible to the editor process
```

The sidebar treats Muse as ready only when the CLI is present **and** credentials are visible (`META_API_KEY` in the editor env, `~/.config/muse/auth.json` with an inline key/token **or** a Keychain-backed `muse login`, or `muse.useEchoProvider`). A key set only in your terminal shell does not reach Cursor/VS Code unless you launch the app from that shell or set it in the GUI environment.

## Install (published)

After this extension is on a marketplace:

- **VS Code Marketplace:** search “Muse CLI Chat” (publisher `codemarc`)
- **Open VSX / Cursor:** same extension id `codemarc.muse-cli-chat`

Or install a local `.vsix`:

```bash
git clone https://github.com/codemarc/muse-code.git
cd muse-code
bun install
bun run package
code --install-extension muse-cli-chat-0.1.8.vsix
# Cursor: cursor --install-extension muse-cli-chat-0.1.8.vsix
```

## Develop

```bash
git clone https://github.com/codemarc/muse-code.git
cd muse-code
bun install
bun run compile
```

Open this folder in VS Code/Cursor and press **F5** (Run Muse CLI Chat Extension). That runs `bun run compile` first (Bun must be on your PATH). Optional: **Run Muse CLI Chat Extension (watch)** for `bun run watch`. In the Extension Development Host:

1. Open a real directory (not a symlink)
2. Command Palette → **Muse CLI Chat: Open Chat** (or click the Muse activity icon)
3. Optional: set `muse.useEchoProvider` to `true` for offline JSONL UI testing
4. Se