Source: , , Last updated: 2026-05-13 — v3.8.0

A2A — Agent-to-Agent
ACP — CLI Agents Registry
Cloud Agents

Spec: A2A v0.3 OmniRoute endpoint: (JSON-RPC 2.0) Agent Card:

— submit a message, receive sync response
• — submit + receive SSE-streamed progress events
• — read task by ID
• — cancel a running task

— route a prompt through the optimal combo
• — report per-provider quota state
• — list installed providers with capabilities
• — estimate cost of a request/conversation
• — aggregate breaker/cooldown/lockout state per provider

A2A-SERVER.md for transport details, agent card structure, task TTL config, and the template for adding new skills.

OmniRoute endpoint: Source:

local CLI agent inventory. It detects which coding CLIs are installed on the host (Cursor, Cline, Claude Code, Codex CLI, Continue, etc.), resolves their versions, and surfaces them to the dashboard so the user can wire each CLI to point at OmniRoute.

CLI-TOOLS.md).

/ per OS)
• )

in ):

{
  "action": "add|update|remove",
  "id": "cursor",
  "name": "Cursor",
  "binary": "/usr/local/bin/cursor",
  "versionCommand": "--version",
  "providerAlias": "cursor",
  "spawnArgs": ["--api-base", "http://localhost:20128"],
  "protocol": "stdio"
}

• fingerprint matrix

run tasks. It only detects + configures CLIs. To actually invoke a CLI, you launch it yourself with the env vars OmniRoute provides (, , etc.).

OmniRoute endpoints: (lifecycle) + (plumbing) Source:

)

— OpenAI Codex Cloud
• — Cognition Devin
• — Google Jules

All endpoints require management auth (commit ). Bearer-only callers receive 401 since v3.8.0.

CLOUD_AGENT.md for the contract, per-agent specifics, schema details, and credential plumbing endpoints.

	)
	for ; management for REST helpers

curl http://localhost:20128/.well-known/agent.json

curl -X POST http://localhost:20128/a2a \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "message/send",
    "params": {
      "messages": [{"role": "user", "content": "Route this prompt"}],
      "skillId": "smart-routing"
    },
    "id": 1
  }'

curl http://localhost:20128/api/acp/agents \
  -H "Authorization: Bearer <api-key>"

curl -X POST http://localhost:20128/api/acp/agents \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "add",
    "id": "my-custom-cli",
    "name": "My Custom CLI",
    "binary": "/opt/mycli/bin/mycli",
    "versionCommand": "--version",
    "providerAlias": "openai"
  }'

curl -X POST http://localhost:20128/api/v1/agents/tasks \
  -H "Cookie: auth_token=..." \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "devin",
    "prompt": "Implement feature X in repo Y",
    "repo": "https://github.com/user/repo",
    "branch": "main"
  }'

curl http://localhost:20128/api/v1/agents/tasks/<task-id> \
  -H "Cookie: auth_token=..."

Chatbot / copilot frontend → (OpenAI-compat — not an agent protocol)
• Multi-agent collaboration → A2A
• Listing local CLIs in the dashboard → ACP
• Delegating long-running coding tasks to cloud services → Cloud Agents

A2A-SERVER.md — A2A deep dive
• CLOUD_AGENT.md — Cloud Agents deep dive
• CLI-TOOLS.md — External CLI integrations (uses ACP)
• SKILLS.md — Skills framework (different from A2A skills — local execution sandbox)
• API_REFERENCE.md — endpoint reference