Agent API

Prefer the local Id CLI for coding on your machine. The gateway also exposes an HTTP agent surface for handoffs, long runs, and remote orchestration — same Bottom meter, same idl_ keys.

Local CLI (recommended)

# from github.com/manishthatte/id
pnpm install && pnpm install:Id
export ID_API_KEY=idl_…
Id ask "Explain README" --budget 0.05 --yolo
Id -p "…" --budget 0.05
Id run "…" --explore "map packages"
Id best-of-n "…" --best-of-n 3
Id handoff "long overnight task"
Id serve --acp

Full command list: CLI reference. Product: Id.

Cloud agent runs

curl https://gateway.idlidu.dev/v1/agent/runs \
  -H "Authorization: Bearer idl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "input": "Summarize latest idlidu finance filings",
    "mode": "bottom",
    "ui_mode": "ask",
    "budget_usd": 0.50,
    "max_steps": 20,
    "tools": ["web_fetch", "idlidu.finance.query"]
  }'

• ui_mode: ask | plan | agent | debug
• Routing mode: bottom | pin (with concrete model)
• budget_usd / max_steps — hard caps for the run
• SSE events include budget / progress updates

Telemetry ingest: POST /v1/telemetry/events (consented classes: usage · behaviour · thinking · writing). See id repo docs/TELEMETRY.md and app traces.

Embeds

• Id serve — NDJSON / JSON-RPC for VSCodium
• Id serve --acp — ACP-shaped stdio
• Extension: @idlidu/id-vscodium (Open VSX / .vsix, not MS Marketplace)

Auth & billing

Same prepaid stack as chat completions. See Gateway and Billing.

Id · CLI · Bottom routing · Docs hub