docs

API

The API is local-first and binds to 127.0.0.1 by default because it controls real terminal processes.

Endpoints

GET  /health
POST /v1/sessions
GET  /v1/sessions/:id
POST /v1/sessions/:id/input
POST /v1/sessions/:id/resize
POST /v1/sessions/:id/cancel
GET  /v1/sessions/:id/transcript
GET  /v1/sessions/:id/events

Create a session

POST /v1/sessions
content-type: application/json

{
  "agent": "claude",
  "prompt": "Implement this task and end with COMPLETED",
  "cols": 120,
  "rows": 40
}

Send input

POST /v1/sessions/:id/input

{
  "text": "continue\n"
}

Signals

The current detector recognizes COMPLETED, FAILED, QUESTION, PLAN_READY, REVIEW_DONE, and ALL_TASKS_DONE.

Events stream

The WebSocket stream emits PTY output chunks, signals, lifecycle transitions, and exit status.