mc-clayrune-apislisted
Install: claude install-skill ronle/clayrune
# Clayrune API surface
Clayrune runs locally at **http://localhost:5199**. Every Clayrune-aware operation is a curl call to this base URL.
## Process Registration — MANDATORY for any spawned process
If you spawn a background process, server, bot, or any long-running command, you MUST register it. Unregistered processes cannot be monitored or stopped by the user.
```bash
# 1) Spawn and capture PID
mycommand &
PID=$!
# 2) Register
curl -s -X POST http://localhost:5199/api/processes/register \
-H "Content-Type: application/json" \
-d "{\"pid\":$PID,\"name\":\"Short description\",\"project_id\":\"<pid>\",\"command\":\"the command run\"}"
```
PID must be an integer. Do not skip registration.
## Backlog (per-project task list)
When the user says "backlog", "backlog items", "the list" — they mean THIS, not files on disk.
- Read: `GET /api/project/<pid>/backlog`
- Update: `PATCH /api/project/<pid>/backlog/<item_id>` with `{"status":"done"}` — status values: `open`, `in_progress`, `blocked`, `done`
- Add note: `POST /api/project/<pid>/backlog/<item_id>/note` with `{"text":"..."}`
- Add item: `POST /api/project/<pid>/backlog` with `{"title":"...","priority":"high|medium|low","note":"..."}`
## Scheduler (Clayrune LOCAL — for jobs that outlive a session)
For long-term, repeatable jobs that should re-run an agent inside Clayrune after the current conversation ends.
- List: `GET /api/schedules`
- Create: `POST /api/schedules` with:
```json
{"project_id":"...","task":"..