01 / Initialize & verify runtime
Checks the local Python environment, SQLite database lock, and stdio transport.
agentdrift-mcp doctor
Install AgentDrift
Choose a package manager and verify the runtime in one step.
brew tap sayon999-d/tap && brew install agentdrift-mcpConfirm installation and check dependencies
agentdrift-mcp doctor Unified Command Reference
One command surface for local SQLite workspaces and cloud MCP endpoints.
CONNECTION
LOCAL · STDIO IPC · 0.4msRUNTIME RESOLVER
Embedded SQLite · ~/.agentdrift[PASS] Python runtime available
[PASS] SQLite WAL lock acquired
[PASS] stdio transport ready
[INFO] Target: local workspace02 / Run MCP server
Starts the local MCP server over stdio IPC with the embedded SQLite workspace.
agentdrift-mcp run--url https://<service>.onrender.com/sse03 / Inspect commits & locks
Reads chronological TaskExecutionCommit streams from the local SQLite ledger.
agentdrift-mcp log
04 / Query shared memory
Reads shared contracts, schema definitions, and task state from local storage.
agentdrift-mcp memory get <key>
05 / Register a task commit
Submits a structured task commit record to the local shared memory bus.
agentdrift-mcp commit --agent <name> --summary "<msg>" --files "<paths>"
06 / Circuit breaker diagnostics
Shows active locks, redundant file overwrites, and local circuit-breaker trip counts.
agentdrift-mcp drift status
No matching commands.
Architecture & dataflow
Packets move through a shared write bus supervised by AgentDrift Core.
Agent NodesCodex · ClaudeCline · Windsurf
AgentDrift CoreRUNTIME SUPERVISOR
Storage LedgerSQLite WAL / Postgres
IN FLIGHT 03PIPELINE NOMINALLOCK AVAILABLE
Agent commitOrthogonal event routing · shared ledger · active loop guardLocal IPC · 0.4ms avg
Client configuration generator
Generate a transport-aware configuration for 13 agent environments.
Claude Desktop
claude_desktop_config.json
Engineering matrix
Runtime supervision and static code maps solve different layers of the problem.
| Capability | AgentDrift MCP | Static AST graph tools |
|---|---|---|
| Scope | Live runtime execution ledger; commits, sessions, and state changes as they happen. | Static parsing of source files into symbol and dependency graphs. |
| Agent coordination | Shared write bus, cross-agent memory, and lock manager coordinate concurrent work. | Usually single-agent, read-only snapshots of repository structure. |
| Guardrails | Active circuit breaker and loop interrupter stop redundant execution. | Passive symbol querying; no runtime intervention. |
| Best used for | Supervising multi-agent execution and preventing duplicate or conflicting changes. | Understanding code structure and navigating large repositories. |
Live execution stream
Trigger sample TaskExecutionCommit events and inspect the shared ledger.