Muse Code App for macOS

# 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.

## Features

- 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

## Install

Download the `.dmg` from
[Releases](https://github.com/dttdrv/musecodeapp/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.

## Development

```sh
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`.

## Layout

- `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)

## License

MIT for the code. Meta, Meta AI, and Muse Code are trademarks of Meta Platforms, Inc.;
this project is not affilia