Agent Bridge API

Provider-aware live terminal monitoring for Claude Code and Codex CLI tmux sessions.

Endpoints

List Sessions

GET /api/v1/agent-bridge/sessions?provider={provider_id}

provider is optional. Supported values are claude-code and codex-cli.

{
  "sessions": [
    {
      "provider": "codex-cli",
      "provider_display_name": "Codex",
      "tmux_target": "repo-1234:0.0",
      "session_name": "repo-1234",
      "window_name": "main",
      "pane_id": "%1",
      "cwd": "/home/user/repo",
      "pid": "12345",
      "status": "active"
    }
  ],
  "count": 1
}

Get Preview

GET /api/v1/agent-bridge/sessions/{target}/preview

Returns a captured pane preview.

Get Terminal Token

GET /api/v1/agent-bridge/token

Returns a short-lived one-time token for WebSocket terminal access.

Attach Terminal

WS /api/v1/agent-bridge/sessions/{target}/terminal?token={token}&mode={mode}

mode can be readonly or interactive.

Spawn Session

POST /api/v1/agent-bridge/sessions

Claude Code example:

{
  "provider": "claude-code",
  "directory": "/home/user/repo",
  "mode": "plain",
  "prompt": "Review the current branch"
}

Codex example:

{
  "provider": "codex-cli",
  "directory": "/home/user/repo",
  "mode": "resume",
  "use_last": true,
  "model": "gpt-5.5",
  "approval_policy": "on-request"
}

Delete Session

DELETE /api/v1/agent-bridge/sessions/{target}

Kills the tmux session or pane target.

Legacy Route

/api/v1/cc-bridge/* remains for compatibility. New clients should use /api/v1/agent-bridge/*.