API reference
The local Hono API for sessions, streaming, and discovery.
Base URL
http://localhost:3000/apiThe launcher normally manages a local API on an available port. When developing the API independently, the default port is 3000.
Endpoints
| Method | Path | Purpose |
|---|---|---|
| GET / POST | /sessions | List or create sessions. |
| GET / PATCH / DELETE | /sessions/:id | Inspect, update, or delete a session. |
| GET | /sessions/:id/messages | Read persisted conversation history. |
| POST | /vibe/stream | Start a streaming agent response. |
| GET | /vibe/:sessionId/reconnect | Reconnect to an active stream. |
| GET | /agents | Inspect the worker roster. |
| GET | /workspaces/:id/git | Read branch and working-tree status. |
| GET | /health | Check API health. |
A streaming request
curl -N http://localhost:3000/api/vibe/stream \
-H "Content-Type: application/json" \
-d '{
"messages": [{ "role": "user", "content": "Explain this repository" }],
"mode": "plan"
}'Include session_id to continue a session. The response is a stream, not a single JSON document. Clients should consume the stream protocol rather than expecting one final response object.
Read the source contract
Request validation and streaming endpoints live in apps/api/src/routers/vibe.ts. The API entry point, model factory, and stream coordinator define the remaining server behavior.
Use the repository’s web or terminal client as a reference when implementing reconnection, tool approvals, or custom data-part rendering.
Improve this page Grounded in the Vibes source.