Muse Code Desktop

# Muse Code Desktop

[![CI](https://github.com/srikantmehra57/muse-code/actions/workflows/ci.yml/badge.svg)](https://github.com/srikantmehra57/muse-code/actions/workflows/ci.yml)
[![Release](https://img.shields.io/github/v/release/srikantmehra57/muse-code?include_prereleases)](https://github.com/srikantmehra57/muse-code/releases)
[![License](https://img.shields.io/github/license/srikantmehra57/muse-code)](LICENSE)

A native desktop command center for the Muse Code CLI. Muse Code Desktop brings sessions, approvals, reasoning controls, changed files, and agent activity into one focused interface while keeping the official Muse CLI as the execution engine.

> [!IMPORTANT]
> Muse Code Desktop is an independent open-source project and is not affiliated with Meta. It requires the official `muse` CLI and an active Muse Code subscription or API key.

## Highlights

- Organize workspaces, sessions, and archived threads from one sidebar.
- Follow streaming agent activity, plans, tool calls, approvals, and background work.
- Choose models, reasoning effort, and approval behavior from the composer.
- Attach files and images with the native picker or drag and drop.
- Review changed files and unified diffs without leaving the conversation.
- Use light and dark themes with seven accent palettes.
- Keep API keys in the operating system credential store.
- Run on the native operating system webview through Tauri 2.

## Download

Download the current macOS beta from the [v0.1.0 release](https://github.com/srikantmehra57/muse-code/releases/tag/v0.1.0).

The initial macOS build is for Apple silicon and is not notarized. On first launch, right-click **Muse Code** and choose **Open**. Windows packaging is supported by the project but a verified Windows installer is not included in this release.

## Prerequisites

- The official Muse Code CLI available as `muse`
- A Muse Code subscription or `META_API_KEY`
- Git for the changed-files review

Install Muse Code CLI:

```bash
# macOS / Linux
curl -fsSL https://dev.meta.ai/install.sh | sh

# Windows PowerShell
irm https://dev.meta.ai/install.ps1 | iex
```

Sign in from the CLI with `muse` and `/login`, or configure an API key in the desktop app under **Settings → Account**.

## Account and credential behavior

**Settings → Account** controls which credential the local Muse process uses:

- **Automatic** uses the signed-in subscription