Muse Companion
Your bridge between VS Code and your Muse assistant — move code, context,
and whole projects between your editor and your AI chat in one click.
Features
💬 Copy Selection for Muse
Select any code, right-click → Muse: Copy Selection for Muse. It copies the
snippet wrapped with its file name and language as a ready-to-paste Markdown
prompt. Paste it into your Muse chat and your assistant instantly has the
context it needs.
📄 Copy Active File for Muse
Same idea for the whole file — from the command palette or the Explorer
right-click menu.
📦 Bundle Project for Muse
Working on something bigger? Muse: Bundle Project for Muse walks your
project folder (smartly skipping node_modules, .git, build output, and
binary files) and generates a single muse-bundle.md containing every relevant
source file. Send that one file to Muse and it can see — and work on — your
entire project.
Bundle size caps are configurable:
muse.bundleMaxFileKB (default 200) — max size per file
muse.bundleMaxTotalKB (default 800) — max total bundle size
💬 Muse Chat (in the editor)
Muse: Open Muse Chat opens a chat tab beside your code, in the style of the
Claude Code panel. Ask Muse to work on your project and watch the conversation
stream in: your message, Muse's reply, every tool it runs (with a diff summary
like +3 −1 in 1 file and its output), and permission prompts you answer
with a click (allow once, allow for the session, deny). A Stop button
interrupts a running turn and New chat starts fresh.
Under the hood the extension runs Muse Code
(muse serve) on your open project folder, so Muse reads and edits your local
files directly. If Muse Code isn't installed, the extension offers to install
it (irm https://dev.meta.ai/install.ps1 | iex on Windows,
curl -fsSL https://dev.meta.ai/install.sh | bash on macOS/Linux). No VS Code
restart is needed afterwards. Muse: Check Setup shows what is ready and what
is missing (project folder, Muse Code, sign-in) and offers to fix it.
Muse: Sign In to Muse Code runs the browser sign-in and detects when the
login is saved.
The Muse web chat (muse.ai) forbids being embedded in other apps, so this
panel is built on Muse Code instead. Open chat in browser still opens the
website.
⚡ Muse Code in the Terminal
Muse: Open Muse Code in Terminal runs the plain Muse Code terminal UI in your
project folder, if you prefer it.
🔌 Send via API (coming soon)
A placeholder for the future: the day Meta ships a public Muse API, the
muse.apiEndpoint / muse.apiKey settings are ready and this command lights
up. Until then it points you at the copy/paste workflow above.
🛠️ Fix This Error
Put your cursor on a line with a red squiggle and run Muse: Fix This Error
(right-click menu too). It copies the exact diagnostic message plus the
surrounding code as a prompt — paste it into chat and get a fix.
❓ Ask Muse About Selection
Muse: Ask Muse About Selection asks you a question first ("Is there a bug
here?", "How can I make this faster?"), then bundles it with your selected
code (or the whole file) into a ready-to-paste prompt.
✨ Apply Code from Clipboard
The loop-closer: copy a code answer from your Muse chat, then run
Muse: Apply Code from Clipboard. It extracts the code block and applies it —
over your selection, replacing the whole file, or inserted at your cursor.
No more manual copy-paste-and-reindent.
A dedicated Muse icon in the activity bar opens a sidebar with every
command one click away — chat, code actions, bundler, and the Muse Code
terminal launcher.
Requirements
- VS Code
^1.80.0
- Muse Code — needed for the in-editor agent (the extension can install it for you)
Getting started
- Install the extension.
- Open any project.
- Press
Ctrl+Shift+P and run Muse: Open Muse Chat.
- Select some code, right-click → Muse: Copy Selection for Muse, paste it
into the chat, and watch your assistant work with full context.
Extension settings
| Setting |
Default |
Description |
muse.bundleMaxFileKB |
200 |
Max KB per file in project bundles |
muse.bundleMaxTotalKB |
800 |
Max total KB per project bundle |
muse.credentialStorage |
system |
file stores the Muse login in ~/.config/muse/auth.json if the keychain fails |
muse.apiEndpoint |
"" |
Reserved: future Muse API endpoint |
muse.apiKey |
"" |
Reserved: future Muse API key |
Known limitations
This extension cannot message your assistant directly — that requires a public
Muse API, which doesn't exist yet. Everything it does today is the real,
working version of the loop: grab code with context in VS Code → paste into
Muse chat → get code back. The muse.sendViaApi command is the single function
to implement when an API ships.
Release notes
0.4.1
- Billing errors from Meta (HTTP 402) now show Open billing / Subscription guide
buttons in the chat banner
- New setting
muse.credentialStorage (system | file): choose file if the
browser sign-in succeeds but the login is never saved (Windows keychain write failure)
0.4.0
- Muse Chat: a real chat panel in the editor (streaming replies, tool-call
cards with diff summaries, click-to-approve permission prompts, Stop, New chat),
driven by
muse serve. Replaces the blank web page.
- "Open Muse Code in Editor" is now Open Muse Chat; the terminal UI remains
available as Open Muse Code in Terminal
0.3.2
- Sign-in awareness: Muse: Check Setup now shows whether you are signed in
(account login or
META_API_KEY) and Muse Code launches only after offering
to sign you in
- New command Muse: Sign In to Muse Code — runs
muse login and tells you
when the login has actually been saved
0.3.1
- Setup check before launching: prompts you to open a project folder and to
install Muse Code (one click, output in the "Muse Companion" log) if missing
- Finds Muse Code in its installer folder right after install — no VS Code
restart needed
- New command Muse: Check Setup (also in the sidebar)
0.3.0
- Replaced the blank in-editor chat page (the site blocks embedding) with Muse Code
hosted in an editor tab, working on your open project folder
- Windows-aware Muse Code launch and one-click installer prompt
- Sidebar buttons updated
0.2.3
- Fixed the Muse sidebar showing an empty panel (view is now declared as a webview)
- New monochrome activity-bar icon that follows your theme
- Fixed
muse.bundleMaxFileKB, muse.bundleMaxTotalKB and muse.apiEndpoint
settings being ignored
- Removed the startup diagnostic notification
0.2.2
- Diagnostic build: activate on startup + visible activation ping
0.2.1
- Fixed sidebar not loading in some setups (rely on automatic view activation;
allow untrusted/virtual workspaces)
0.2.0
- New: Fix This Error (diagnostic + code context in one prompt)
- New: Ask Muse About Selection (question + code bundling)
- New: Apply Code from Clipboard (paste chat answers straight into files)
- New: Muse sidebar panel in the activity bar with all commands
0.1.1
- Added extension icon
- Expanded marketplace README
0.1.0
- Initial release: copy selection/file, project bundler, in-editor chat page,
Muse Code terminal launcher, API placeholder.
Built with Muse. Published by FletMedia.
Muse Companion is an independent, community-made extension. It is not
affiliated with, endorsed by, or sponsored by Meta. "Muse" and "Meta" are
trademarks of their respective owners.