shipwithmuse

№ 0072GitHub

muse-code-acp adapter for ACP editors

muse-code-acp is an unofficial Node adapter that exposes Meta's Muse Code through the Agent Client Protocol, so it can be driven from Zed or VS Code with streaming, tool calls and MCP servers.

muse-code-acp adapter for ACP editors on github.com
bex-co/muse-code-acpREADME ↗
# muse-code-acp

Use [Muse Code](https://dev.meta.ai/docs/muse-code/) through an
[Agent Client Protocol (ACP)](https://agentclientprotocol.com) client, such as
Zed or VS Code with an ACP extension. Available features depend on the client.

> **Unofficial adapter.** Muse Code and Muse Spark are products of Meta
> Platforms, Inc. This community project is not affiliated with, endorsed by,
> or supported by Meta.

## Requirements and compatibility

- **Node.js 22+** for the npm installation.
- **Muse Code 1.1.1-R2514.1**, installed separately, with `muse serve`.
  This is the verified host for adapter **0.5.x**; the latest Muse installer
  may install a different version. Select the verified binary with
  `MUSE_CODE_EXECUTABLE`.
- Muse authentication through browser login or `META_API_KEY`.

**The supported baseline remains Muse 1.1.1-R2514.1.** Adapter **0.5.0** also
verifies SDK-created session load/resume, multi-stage allow/deny,
and HTTP MCP tool calls and startup failures on **1.2.1-R2847.1**. ACP-provided
MCP servers explicitly use required startup mode; authentication, malformed
responses and unreachable endpoints fail the prompt.

One host limitation remains on 1.2.1: legacy `muse exec` sessions saved with
`:auto-review` cannot be resumed in `muse serve`, whose automated reviewer is
unavailable. This affects the legacy-continuation portion of three live tests;
SDK-created session continuation passes. The adapter reports an actionable error
and does not replay the prompt or change the saved permission profile. Start a
new ACP session or continue the old one in Muse with reviewer support.

The launcher updates and removes superseded binaries, so pointing
`MUSE_CODE_EXECUTABLE` at an old launcher cache is not a durable pin. CI's public
1.1.1 artifacts remain downloadable; the exact macOS ARM64 and Linux download
URLs and SHA-256 checks are in [CI](.github/workflows/ci.yml). Keep the verified
binary at a separate path. These fixes are included in **0.5.0**.

The npm adapter and its pinned `@muse-code/sdk@0.1.1` dependency do not include
the Muse executable. Native execution, model access, persistence and sandboxing
remain owned by Muse.

## Quickstart

Install Node.js and the verified Muse host above, then replace the example path:

```sh
export MUSE_CODE_EXECUTABLE="/absolute/path/to/muse-1.1.1"
"$MUSE_CODE_EXECUTABLE" --version
"$MUSE_CODE_EXECUTABLE" ser

Also filed under Coding & dev tools

See all →
  1. 0561

    Muse-Desktop★

    A desktop app for Muse Code on macOS and Windows with projects, git worktrees, subagents, MCP, a diff review panel and opt-in computer use that lets the agent see the screen and use apps.

    @EtienneLescot

    GitHub

    Coding & dev tools

  2. 0547

    MuseGlass★

    A hands-free interface that turns Meta AI glasses into a voice control surface for Muse Code on a Mac: assign a task, walk away, hear progress, interrupt and approve sensitive steps.

    @MoheetBrain

    GitHub

    Coding & dev tools

  3. 0150

    Helicon: desktop app for Muse Code★

    I pay for @Muse Code but didn't want to live in a terminal. On Windows it's WSL-only. So I built Helicon: an open-source desktop app for the actual Muse CLI. • uses your existing muse login, no API key • talks to muse serve over MSP, so Muse stays the agent • resumes

    @harjjotsinghh

    X post

    Coding & dev tools

  4. 0128

    Helicon desktop app for Muse Code★

    Helicon is an open-source desktop and web app that wraps Meta's Muse Code CLI in a Codex/Claude-style interface, grouping sessions by project with history, resume and diffs on Windows, macOS and WSL2.

    @HarjjotSinghh

    GitHub

    Coding & dev tools

More GitHub

See all →
  1. 1074

    Ziggy, a 24/7 voice assistant on Muse Spark

    An always-on laptop voice companion: local Porcupine wake word, local Whisper speech-to-text in Hindi and English, Muse Spark via the Meta Model API as the brain, offline TTS and local conversation memory.

    @TanayYadavDev

    GitHub

    Agents & automation

  2. 1066

    Muse remote-control bridge for Intel Macs

    Since Muse for Mac ships only for Apple silicon, this small service lets Muse's cloud VM screenshot, click and type on an Intel Mac, compressing each 5K frame to about 150 KB and handling Retina coordinate scaling.

    @LilMuh

    GitHub

    Errands & personal agent

  3. 1040

    CursorBench 4.0 score-vs-cost report

    A self-contained visual report comparing CursorBench 4.0 score against cost per task for Opus 5.5, Fable 5.1, Grok 4.7 and Muse Spark 1.3, where Muse Spark 1.3 Max scores 41.6% at $2.64 per task. GPT-6 points are clearly marked as estimates.

    @dominicletz

    GitHub

    Benchmarks & research

  4. 0995

    BitNet Gateway: cheap CPU triage, Muse Spark decides

    A hybrid FastAPI gateway where a 1-bit BitNet layer on CPU filters routine traffic and Muse Spark 1.3 is called only for sales, urgency, money or low-confidence cases; the author estimates the local filter handles about 60-70% of volume.

    @rafaelnovaes22

    GitHub

    Agents & automation

Curator picks

  1. 1046

    Medical bills audited line by line, $4,000 saved★

    Got Muse logged in to my medical provider’s portal, he pulled the itemized bills, and questioned every line. So far he’s found several times I’d been double billed, asked for some discounts and has saved me over $4,000. If your moat is bureaucracy, you’re cooked.

    @Ryan_Holdaway

    X post

    Errands & personal agent

  2. 1013

    Shop Pay agentic checkout on every Shopify store★

    We are excited to announce we are partnering deeply with Muse to enable agentic checkout with Shop Pay on all Shopify stores, offering people an easy and delightful way to shop and check out with Muse.

    @tobi

    X post

    Business & commerce

  3. 1009

    Private e-book library app from Google Drive★

    Muse built me a private library for the e-books and articles in my Google Drive. Everything is organized by topic, and each section opens onto its own subcategorized shelves. Each book opens like a real book and is readable in-app

    @chiasmus_cap

    X post

    Apps & websites

  4. 1007

    Plumbing company run by a Muse agent★

    I still can’t believe I can run my plumbing company with an agent so easily. I send this message to my Muse agent while in bed at 6am. And it: updates my job board, texts customer, updates office manager who arrives at 8am in slack Notifies technician

    @HouseHackerJon

    X post

    Agents & automation