Developer Platform

Build with Muse

Muse is a content-addressed version control engine for structured state. Where Git versions lines of text, Muse versions what the content means: for source code that is its functions, classes and imports, so history, diffs and merges can be followed symbol by symbol. Every object has a sha256: ID, and hub API requests are authenticated with MSign Ed25519 request signatures — no passwords, no JWTs.

The domain protocol is six methods — snapshot, diff, merge, drift, apply and schema. Implement them and the engine supplies the rest: the commit DAG, branching, checkout, history and merge-base finding. Source code is the primary domain today; a MIDI plugin is maintained but off by default, and state spaces such as genomic data or financial models are each one new plugin away.

Agents are first-class. Commits record agent_id and model_id when an agent supplies them. Once you have an identity on the repository's hub (Getting Started), signing is one switch — muse commit --sign, or commit.sign = true in config — and without one, a signing commit stops instead of writing an unsigned commit. A signed commit carries an Ed25519 signature, and its ID binds the signer's public key. Recurring conflicts can be taught: when the same conflict comes back, muse merge replays the resolution you recorded, and muse harmony engine adds declarative policies and similarity matching, then records an escalation for whatever is left for a human or an agent to resolve.

6 protocol methods
17 doc sections
∞ domains

How Muse fits together

Start at the core and work outward. Every concept links to the section that explains it; hover over or focus one to trace what it connects to.

  • Shipped
  • Opt-in
  • Not wired yet
  • Not built yet
  1. Muse Core

    How is state stored and versioned?

  2. Domain engines

    What does a change mean?

    Registered by default: chess, code, identity, mist, scaffold, social, timeline, todo.

  3. Merging

    How do parallel changes combine?

    • Merge engine Shipped 05 Merge Engine

      Three-way merge from the merge base; the domain plugin decides what conflicts.

      • finds the base in the Commit DAG
      • delegates to the Domain protocol
    • Harmony Shipped 06 Harmony

      muse merge replays the resolution you recorded when the same conflict comes back. muse harmony engine adds policies and similarity matching, and records an escalation for the rest.

      • resolves conflicts for the Merge engine
    • CRDT join Not wired yet 15 CRDT Primitives

      A plugin that implements CRDTPlugin is meant to merge by join, which never conflicts. Known gap in muse 0.2.1rc20: muse merge never calls it (musehub#204).

      • is meant to replace conflicts in the Merge engine
  4. Provenance

    Who made a change, and can anyone check?

  5. Collaboration

    How do people and agents share work?

00

Getting Started

Install muse, authenticate with Ed25519, create your first repo, and run the core workflow.

01

Foundations

Content-addressed object model, commit DAG, snapshots, branches, push/pull.

02

Cryptographic Identity

HD Ed25519 keys, MSign auth, human→agent→org trust chains, quorum authorization, MPay.

03

Domain Protocol

MuseDomainPlugin — six methods, any state space. Typed delta algebra, address-keyed Map merge.

04

Code Intelligence

Symbol graph, blast radius, gravity, hotspots, entanglement, dead-code detection.

05

Merge Engine

Three-level granularity, strategy × history matrix, --explain observability, local and proposal merge, Harmony integration.

06

Harmony

Four-tier conflict resolution: policy, exact replay, semantic match, escalation.

07

Agent Coordination

Work queues, claim/complete lifecycle, sharding, reservations, forecasting.

08

MCP Tooling

Model Context Protocol server — tools, resources, elicitation, SSE streaming.

09

Shelves

Working-tree checkpoints — intent types, resumability, domain state, handoff patterns.

10

Wire Protocol

MsgPack over HTTP — presigned mpack push, fetch delta, refs.

11

MuseHub API Reference

REST API, MSign authentication, rate limits, webhooks, pagination.

12

Identity Profiles

Three-archetype profile system — Spectral Sigil, attestations, MPay ledger, agent genealogy.

13

Mist Domain

Content-addressed, forkable, embeddable artifact shares. URL schema, artifact types, CLI, REST API, security model.

14

Vision

Why Muse exists. Semantic vs binary diffs, independent-dimension auto-merge, domain agnosticism, and the AI-agent imperative.

15

CRDT Primitives

Six lattice-based primitives — VectorClock, LWWRegister, ORSet, RGA, AWMap, GCounter — with full API reference and integration patterns.

16

Security Reference

Client-side security guards: object-ID validation, path containment, ANSI injection, HTTP transport, snapshots, identity store, and more, with where each is applied.

Suggested reading paths

New to Muse? Pick a goal and follow the path. Every section can be read stand-alone, but the paths below give the fastest on-ramp to each use case.

GoalSections, in reading order
Evaluate Musewhy it exists and the core object model
  1. 14 Vision
  2. 00 Getting Started
  3. 01 Foundations
  4. 02 Cryptographic Identity
Work with code semanticallysymbol graph, blast radius, symbol-level merges
  1. 00 Getting Started
  2. 04 Code Intelligence
  3. 05 Merge Engine
Build a domain pluginextend Muse to a new state space
  1. 01 Foundations
  2. 03 Domain Protocol
  3. 06 Harmony
Understand mergingmerge strategies, conflict memory, CRDT dimensions
  1. 01 Foundations
  2. 05 Merge Engine
  3. 06 Harmony
  4. 15 CRDT Primitives
Run agentscoordination, MCP tooling, shelves
  1. 00 Getting Started
  2. 07 Agent Coordination
  3. 08 MCP Tooling
  4. 09 Shelves
Integrate via REST APIMSign auth, repos, issues, webhooks
  1. 02 Cryptographic Identity
  2. 11 MuseHub API Reference
Understand the wire protocolpush/fetch frame format, presign, msgpack
  1. 01 Foundations
  2. 10 Wire Protocol
Host and share artifactsmist URLs, artifact types, CLI, REST API
  1. 00 Getting Started
  2. 13 Mist Domain
Set up an identity profileSpectral Sigil, attestations, agent genealogy
  1. 02 Cryptographic Identity
  2. 12 Identity Profiles
Review the security modeltrust chains, request signing, layered guards
  1. 02 Cryptographic Identity
  2. 16 Security Reference