taikutaiku
User GuidePluginsAPI Reference
Remote Commands
GET/v1/sessions/{session_id}/remote/agents

Returns detected AI agents (Claude, Codex, OpenCode) running in your terminals — with their type, model, token usage, and session IDs. Useful for monitoring costs.

Authorization

apiKeyAuth
X-Taiku-Token<token>

Your API key from taiku login. Also available as TAIKU_TOKEN env var.

In: header

Path Parameters

session_id*string

Query Parameters

client?integer

Optional target browser client ID. Useful when multiple clients are connected to the same session.

Range0 <= value

Response Body

application/json

text/plain

text/plain

text/plain

text/plain

text/plain

text/plain

curl -X GET "/api/v1/sessions/string/remote/agents"
{
  "result": [
    {
      "shellId": 1,
      "agentType": "claude",
      "model": "opus-4",
      "sessionId": "abc-123",
      "tokenUsage": {
        "input": 50000,
        "output": 12000,
        "cached": 30000,
        "cost": 0.42
      }
    }
  ]
}
"Command failed"
"Unauthorized"
"Not the session owner"
"Session not found"
"Session closed"
"No active browser clients responded"