Local API

The standalone daemon exposes a REST API and WebSocket at http://localhost:3847.

REST Endpoints

Get Status

GET /api/v1/status

Returns daemon status, connected IDEs, and system info.

List Connected IDEs

GET /api/v1/ides

List CLI Sessions

GET /api/v1/clis

Send Command

POST /api/v1/command
Content-Type: application/json

{
  "type": "send_chat",
  "target": "standalone:ide:cursor_12345",
  "payload": {
    "message": "Fix the login bug"
  }
}

Available Command Types

Command	Description
send_chat	Send a message to the AI agent
read_chat	Read current chat messages
screenshot	Capture IDE screenshot
list_chats	List available chat sessions
new_chat	Start a new chat session
switch_chat	Switch to a different chat
set_mode	Change agent mode
change_model	Switch AI model

WebSocket

Connect to ws://localhost:3847/ws for real-time updates:

const ws = new WebSocket('ws://localhost:3847/ws');
ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log('Update:', data);
};

Authentication

By default, the local API has no authentication. To enable:

npx @adhdev/daemon-standalone --token mysecret

Then include the token in requests:

curl -H "Authorization: Bearer mysecret" \
     http://localhost:3847/api/v1/status