Muse Code App

Unofficial. Muse Code App is an independent, community-made desktop client for the Muse Code CLI. It is not the official Muse Code app, and it is not affiliated with, endorsed by, or sponsored by Meta Platforms, Inc. Meta, Meta AI, and Muse Code are trademarks of Meta Platforms, Inc.

A native macOS client for the Muse Code CLI, in the Meta AI design language. It wraps the locally installed muse binary, so sessions are shared with the terminal: start a session in the app, resume it with the CLI, and the other way around.

• Chat with Meta AI models (Spark 1.2, contributor tier) using your existing muse login or a Meta API key, with pay-as-you-go credits managed on dev.meta.ai
• Full markdown rendering, reasoning display, and tool-call activity per turn
• Projects with per-folder session history, plus a git panel (branch, changed files, worktrees)
• Skills browser: inspect and toggle the skills the CLI loads
• Reasoning effort, approval mode, sandbox, and tool toggles mapped to CLI flags
• CLI update checks against the stable channel, app updates via GitHub Releases

Download the .dmg from Releases, drag Muse Code to Applications, and right-click Open on first launch (the build is unsigned).

The app ships with the Muse Code CLI bundled and seeds it on first run, so it works out of the box. If you already have muse installed, the app prefers your install and shares its sessions and login. First run walks you through browser login or an API key.

npm install
npm run dev        # electron-vite dev server
npm test           # vitest
npm run build -w packages/protocol   # rebuild the shared protocol package after editing it
npm run dist -w apps/desktop         # electron-vite build + electron-builder dmg (dist/)

MUSE_DRIVER=1 on the built main bundle runs a scripted click-through that screenshots every view to /tmp/muse-driver-*.png.

• apps/desktop - Electron app (main, preload, React renderer)
• packages/protocol - shared types and the CLI JSONL event mapper
• scripts/make-icon.cjs - regenerates apps/desktop/build/icon.png (the app icon is an original mark, not the Meta AI logo)

MIT for the code. Meta, Meta AI, and Muse Code are trademarks of Meta Platforms, Inc.; this project is not affiliated with or endorsed by Meta Platforms, Inc.