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 GET /api/metrics/summary Process metrics summary (?since=) GET /api/metrics/cost Process metrics cost (?bead=&feature=&since=) GET /api/metrics/cycle-time Process metrics cycle time (?since=) GET /api/metrics/rework Process metrics rework (?since=)

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 7743)
      --tls-cert string         TLS certificate file (PEM); auto-generates self-signed cert if omitted
      --tls-key string          TLS private key file (PEM); auto-generates self-signed key if omitted
      --tsnet                   Enable Tailscale ts-net listener (opt-in, see ADR-006)
      --tsnet-auth-key string   Tailscale auth key for headless/CI use (SECURITY: visible in ps/history; prefer TS_AUTHKEY env var)
      --tsnet-hostname string   Tailscale hostname (default: ddx)

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

Auto generated by spf13/cobra on 21-Apr-2026
searchserver install-service