Muse Code for VS Code (unofficial)

# Muse Code for VS Code (Unofficial)

A native VS Code chat UI for [Muse Code](https://developer.meta.com/ai/lp/muse-code/), Meta's agentic terminal coding agent.

> **Unofficial community project.** This extension is not made, endorsed, or supported by Meta. "Muse" and "Muse Code" are Meta's names for their product; they are used here only to describe what the extension connects to.
>
> **Inspired by the Claude Code VS Code extension.** The layout, commands, keybindings, settings and workflow of this extension deliberately mirror Anthropic's [Claude Code for VS Code](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code) so that anyone who knows that extension feels at home. This project is not affiliated with Anthropic or Meta.

- **Works alongside you:** Muse explores your codebase, reads and writes code, and runs terminal commands with your approval.
- **Integrated with the editor:** Muse knows about your current file and text selection, and you can review its file changes as a diff right in the editor.
- **Durable sessions:** resume any past conversation for the workspace, including ones started from the `muse` terminal TUI.
- **Agentic features supported:** approvals with policy amendments, user-input questions, subagents, todo lists, context compaction, model and reasoning-effort selection, and user shell commands.

## Requirements

- VS Code 1.98.0 or higher.
- The `muse` CLI, version 1.0.3 or later. Run `muse login` once before using the extension. The extension looks for `muse` on `PATH`, in common install locations (`~/.local/bin`, `/opt/homebrew/bin`, ...), and via your login shell, so it works even when VS Code is launched from the Dock. Set `museCode.executablePath` only if it still cannot be found.

## Getting started

1. Open a folder.
2. Click the Muse icon in the editor title bar, or press `Cmd+Escape` (`Ctrl+Escape` on Windows/Linux).
3. Type a message and press Enter.

Use `@` to mention files, `/` for commands, and `!` to run a shell command yourself.

## Commands

| Command | Default keybinding |
| --- | --- |
| Muse Code: Open | `Cmd/Ctrl+Escape` (focus) |
| Muse Code: Open in New Tab | `Cmd/Ctrl+Shift+Escape` |
| Muse Code: Open in Side Bar | |
| Muse Code: Open in New Window | |
| Muse Code: Open in Terminal | `Cmd/Ctrl+Escape` when `museCode.useTerminal` is on |
| Muse Code: New Conversation | `Cmd/Ctrl+N` when e