feat: Muse — version control for the agent era
Muse is a ground-up reimagining of version control built for a world where agents and humans collaborate at the speed of thought. Where git tracks line-level changes in files, Muse tracks named symbols across time. The file is the container; the symbol is the unit of meaning.
This is the first commit of the canonical Muse history. The codebase has been under active development and is production-ready. All previous VCS history has been consolidated here.
─── Architecture ───────────────────────────────────────────────────
muse/core/ — object store, snapshot engine, merge engine, coordination, identity, GC, DAG, blame, bisect, pack/unpack, query engine, code intelligence muse/cli/commands/ — 138 CLI commands (commit, branch, checkout, merge, rebase, push, pull, diff, log, snapshot, worktree, workspace, coord, code, auth, ...) muse/plugins/ — domain plugin system (code domain ships by default) tests/ — 290 test files covering unit, integration, CLI, E2E, security, stress, and regression scenarios
~323 000 lines of Python. Zero dependencies on git or GitHub.
─── Core capabilities ──────────────────────────────────────────────
Symbol-level VCS Commits point to content-addressed snapshot manifests (path → SHA-256). `muse diff` shows which named symbols changed, not which lines. `muse merge` resolves at the symbol level — two agents editing different methods of the same class do not conflict.
Agent-first provenance Every commit carries structured provenance: agent_id, model_id, toolchain_id, prompt_hash, Ed25519 signature. Verified with muse verify. `muse shortlog --by agent` groups history by agent instance. `muse code lineage` traces a symbol's full provenance chain.
Code intelligence `muse code grep` — semantic symbol search (not file-text grep) `muse code cat` — read exactly one symbol body, nothing else `muse code impact` — full transitive blast radius of any change `muse code deps` — import graph for a file or symbol `muse code dead` — dead code detection via the live symbol graph `muse code patch` — surgical symbol replacement by name, not line
Swarm coordination (muse coord) Priority queue with atomic claiming, dependency DAG, conflict forecasting, shard partitioning, real-time event stream (kqueue). Designed for thousands of concurrent agent branches.
Worktrees and workspace `muse worktree` — parallel branches sharing one object store `muse workspace` — multi-repo composition (muse, musehub, agentception)
Auth: MSign (Ed25519 per-request signing) No passwords, no JWTs. Every request is signed; replay window = 30s. Per-agent key injection via MUSE_AGENT_KEY env var.
Wire protocol Push/pull over HTTP with content-addressed pack objects. MuseHub (localhost:10003) is the canonical remote.
─── Remote ─────────────────────────────────────────────────────────
http://localhost:10003/gabriel/muse (local dev) https://staging.musehub.ai/gabriel/muse
Files Changed
+614
614 in snapshot
0 comments
muse hub commit comment sha256:1c4b3e3a9a1f300774c3ee662b572a698d5fd405bf765a71e6011a2e9c3eaaaa --body "your comment"
No comments yet. Be the first to start the discussion.