Skip to content
Documentation
CLI Reference
Command Reference
server

server

ddx server

Start the DDx HTTP and MCP server

Synopsis

Start the DDx server exposing documents, beads, document graph, and agent session logs over HTTP REST and MCP endpoints.

HTTP API: GET /api/health Liveness check GET /api/ready Readiness check with dependency status GET /api/documents List library documents (?type=) GET /api/documents/:path Read a document GET /api/search?q= Full-text search across documents GET /api/personas/:role Resolve persona for a role GET /api/beads List beads (?status=&label=) GET /api/beads/:id Show a specific bead GET /api/beads/ready List ready beads GET /api/beads/blocked List blocked beads GET /api/beads/status Bead summary counts GET /api/beads/dep/tree/:id Dependency tree for a bead GET /api/docs/graph Document dependency graph GET /api/docs/stale Stale documents GET /api/docs/:id Document metadata and staleness GET /api/docs/:id/deps Upstream dependencies GET /api/docs/:id/dependents Downstream dependents GET /api/agent/sessions List agent sessions (?harness=&since=) GET /api/agent/sessions/:id Session detail

MCP (POST /mcp): ddx_list_documents List library documents ddx_read_document Read a document ddx_search Full-text search ddx_resolve_persona Resolve persona for a role ddx_list_beads List beads ddx_show_bead Show a specific bead ddx_bead_ready List ready beads ddx_bead_status Bead summary counts ddx_doc_graph Document dependency graph ddx_doc_stale Stale documents ddx_doc_show Document metadata ddx_doc_deps Upstream dependencies ddx_agent_sessions List agent sessions

ddx server [flags]

Options 

      --addr string   Address to bind to (default "127.0.0.1")
  -h, --help          help for server
  -p, --port int      Port to listen on (default 8080)

Options inherited from parent commands 

      --config string              config file (default is $HOME/.ddx.yml)
      --library-base-path string   override path for DDx library location
  -v, --verbose                    verbose output

SEE ALSO

  • ddx - Document-Driven Development eXperience - AI development toolkit
Auto generated by spf13/cobra on 6-Apr-2026
searchstatus