← ClaudeAtlas

mc-clayrune-apislisted

Use whenever you need to interact with Clayrune local APIs — backlog management, scheduler routines, hivemind orchestration, process registration, terminal pop-out, or any localhost:5199 endpoint. TRIGGER when the user mentions "backlog", "schedule", "hivemind", "register this process", "open a terminal", or refers to Clayrune by name.
ronle/clayrune · ★ 13 · AI & Automation · score 80
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":"..