Muse Code

Start, resume, and manage Muse Code sessions

Requires ccmux v0.5.0 or later and the Muse Code CLI from Meta.

Install and sign in

Install Muse Code, then complete its sign-in flow in your browser. Authentication stays with Muse; ccmux does not store your Meta credentials.

brew install --cask muse-code
muse login
ccmux doctor

For other platforms, use Meta’s installer:

curl -fsSL https://dev.meta.ai/install.sh | bash

Start and resume

Create a project with Muse, or choose Muse Code in the TUI’s new-project form. Workspace trust and tool approvals use Muse’s own prompts.

ccmux new muse-demo --agent muse
ccmux resume --agent muse
ccmux list-conversations
ccmux resume <conversation-id>

New projects start fresh. Reopening a project resumes its latest Muse session when available. Selecting a conversation resumes that exact session.

History and usage

Open Conversations to search, preview, resume, or delete a Muse conversation. ccmux reads native session logs, including sessions started outside ccmux.

ccmux list-conversations --query "cache"
ccmux usage
ccmux usage --json

The dashboard and CLI show recorded input, output, cached input, and reasoning tokens. Child-agent usage belongs to its parent session; mirrored records count once. Cost is unavailable because Muse does not provide a reliable price in these logs.

Delete a conversation

Delete from Conversations or use the command below. The CLI asks for confirmation by default. Deletion permanently removes the selected session directory, child logs, and its derived view cache. Active sessions are protected by Muse’s native lock.

ccmux delete-conversation <conversation-id>

Configuration

Muse manages its own settings. ccmux reads sessions from $XDG_DATA_HOME/muse/sessions, falling back to ~/.local/share/muse/sessions. To use a different Muse executable, set its path in ccmux’s config.toml:

[agents.muse]
command = "/path/to/muse"

Found a Muse log format we missed? Open an issue or contribute a PR with a small, redacted example. Remove prompts, personal paths, and credentials before sharing.

Contribute on GitHub

Spotted an error or something out of date? Edit this page on GitHub.