Serve Commands¶

Expose SuperQode to other tools: an ACP agent for editors and benchmarks, MCP and A2A servers for harnesses, and a browser-based TUI.

Servers at a glance¶

A2A is the primary cross-service surface. The public Agent Card is published for discovery; operational requests go to https://a2a.superqode.dev. Local serve a2a works today. See A2A Protocol.

mcp¶

Serve your harness specs over MCP, on stdio by default:

superqode mcp                                  # stdio (for MCP client configs)
superqode mcp --http --host 0.0.0.0 --port 8765
superqode mcp --dir ./harnesses                # serve specs from a directory

A typical MCP client configuration entry:

{
  "mcpServers": {
    "superqode": {
      "command": "superqode",
      "args": ["mcp"]
    }
  }
}

serve acp¶

Run SuperQode as an ACP agent on stdio, for Zed, JetBrains IDEs, Neovim, and Harbor/Terminal-Bench:

superqode serve acp                       # per-session harness discovery
superqode serve acp --spec harness.yaml   # pin one HarnessSpec

SUPERQODE_ACP_SPEC accepts a spec path or template:<name> for a built-in template. stdout carries JSON-RPC, so human-facing output goes to stderr. See the full guide: ACP Agent Server.

serve harness¶

Expose harness workflows as MCP tools with a command that reads like harness-as-a-service:

superqode serve harness --spec harness.yaml
superqode serve harness --dir ./harnesses --http --port 8765

--spec serves the containing directory so relative inherits paths keep working; use the file stem as the harness name.

serve api¶

Serve the local switchboard and Software Factory graph over JSON HTTP.

superqode serve api --port 8766
superqode serve api --host 0.0.0.0 --allow-remote --token "$SUPERQODE_API_TOKEN"

Options:

Useful endpoints:

Remote serving should use --token and a trusted network.

serve web¶

Start the Textual TUI server over HTTP.

superqode serve web [OPTIONS]

Options¶

Examples¶

superqode serve web
superqode serve web --host 0.0.0.0 --port 8080

Uses textual-serve to expose the full SuperQode TUI over HTTP. Open the provided URL in a browser for a terminal-like experience without a local terminal emulator.

serve a2a¶

Expose a HarnessSpec as an A2A 1.0 HTTP+JSON agent:

superqode serve a2a --spec harness.yaml
superqode serve a2a \
  --host 0.0.0.0 \
  --allow-remote \
  --public-url https://superqode.example.com
superqode serve a2a \
  --spec harness.yaml \
  --host 0.0.0.0 \
  --allow-remote \
  --public-url https://superqode.example.com \
  --token "$SUPERQODE_A2A_TOKEN" \
  --expose-harness
superqode serve a2a \
  --host 0.0.0.0 \
  --allow-remote \
  --public-url https://a2a.superqode.dev \
  --export-agent-card examples/a2a/agent-card.json

See A2A Protocol for durability, publishing, and the experimental multiplayer-computer packaging notes.

serve status¶

Inspect server integrations supplied by the optional SuperQode Enterprise package.

superqode serve status

The open-source package reports that this surface requires the Enterprise package. The open-source serve acp, serve a2a, serve harness, serve api, and serve web commands remain available as documented above.