CClawMetryDocs

Runtime reference

Muse Code#

Muse Code is Meta's terminal coding agent on Muse Spark. It is the first runtime ClawMetry reads over a protocol rather than a file format: the adapter starts muse serve and asks Muse's own session protocol (MSP) for sessions, so nothing about the log layout is guessed. This is Muse Code, not the consumer Muse app, which runs only in Meta's cloud and cannot be observed.

Runtime idmuse_code
CategoryTerminal coding agent
VendorMeta
TierPaid tier (Starter and up)
Upstreamdeveloper.meta.com/ai/products/muse-code

Where the data comes from#

ClawMetry reads these locations, in order, and never writes to any of them.

  • $XDG_DATA_HOME/muse (default ~/.local/share/muse) — session-index.db plus sessions/YYYY/MM/DD/<uuid>/session.jsonl, read through MSP
  • ~/.config/muse — settings.json and auth.json only, never session data

Format. Read over MSP (newline-delimited JSON-RPC 2.0) using only its read-only calls: session/list, session/read and view/page. They take no lease, so your own Muse keeps running. The adapter requests no capabilities.

Environment variables#

VariableEffect
XDG_DATA_HOMEMoves Muse's data home; the only lever the muse binary honours
CLAWMETRY_MUSE_HOMEClawMetry-side override for the data home
CLAWMETRY_MUSE_CONFIG_DIRClawMetry-side override for the config dir
CLAWMETRY_MUSE_BINPath to the muse binary when it is not on the daemon's PATH

See Environment variables for the variables that apply to every runtime.

Tokens and cost#

Tokens. Muse's own counted-once session totals from session/tokenUsage events: input, output, cache reads and reasoning tokens, tagged with the model.

Cost. Derived from Meta's published Muse Spark rates. Cached input is inside the input count and is priced at the cached rate, and the standard and contributor tiers are priced separately.

Why this section exists

Runtimes differ enormously in what they persist. Rather than showing a plausible number everywhere, ClawMetry reports what the store actually contains and marks the rest unknown. A cost of $0.00 and a cost of unknown mean different things, and the dashboard keeps them different.

Sub-agents and delegation#

Sub-agents and compaction events appear in the transcript, along with fork lineage when a session is branched.

Things worth knowing#

  • The data home is XDG even on macOS (~/.local/share/muse, not ~/Library/Application Support). MUSE_HOME changes nothing.
  • A session reported notLoaded has not ended; it is only not loaded by ClawMetry's own muse serve.
  • An ephemeral-profile session has no durable log, so it has no transcript.
  • Pause, Stop and Kill are not offered yet: MSP reports no process id, so ClawMetry cannot tie a session to a process it could signal.

Verify it is being read#

bash
# Is this runtime detected, and would this install unlock it?
clawmetry runtimes --json | jq '.runtimes[] | select(.id=="muse_code")'

# Why is it locked, if it is?
clawmetry runtimes --why muse_code

# Any sessions ingested yet?
curl -s 'http://localhost:8900/api/local/sessions?limit=5' \
  | jq '.rows[] | {session_id, agent_id, events, cost_usd}'

If detection succeeds but no sessions appear, work through Troubleshooting — the usual causes are a relocated data directory (set the override above), a session limit that is hiding older runs, or a runtime that simply has not written anything yet.

Edit this page View as Markdown Report an issue
Cookie preferences