Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.claboard.dev/llms.txt

Use this file to discover all available pages before exploring further.

Claude Board uses Tauri’s event system for real-time communication between the Rust backend and the frontend. All board updates, terminal logs, and usage metrics are delivered through Tauri events.

​
Listening for Events

Subscribe to events on the frontend using the Tauri events API: 
import { listen } from "@tauri-apps/api/event";

const unlisten = await listen("task:updated", (event) => {
  console.log("Task updated:", event.payload);
});

// Call unlisten() to unsubscribe when no longer needed

​
Task Events

​
task:created

Emitted when a new task is added to any project. 
{
  "task": { "id": 1, "title": "Add login", "status": "backlog", "projectId": 1 }
}

​
task:updated

Emitted when a task’s fields or status change. 
{
  "task": { "id": 1, "title": "Add login", "status": "in_progress", "projectId": 1 }
}

​
task:deleted

Emitted when a task is removed. 
{ "taskId": 1, "projectId": 1 }

​
Agent Events

​
task:log

Streamed in real-time as the Claude agent produces output. 
{
  "taskId": 1,
  "type": "tool",
  "content": "Reading file: src/app.ts",
  "timestamp": "2025-01-15T10:30:00Z"
}
Log types: claude, tool, tool_result, system, error

​
task:usage

Periodic token usage updates for a running task. 
{
  "taskId": 1,
  "inputTokens": 5000,
  "outputTokens": 1200,
  "cacheRead": 800,
  "cacheCreation": 200,
  "cost": 0.45
}

​
claude:limits

Emitted when the agent encounters API rate limits. 
{
  "taskId": 1,
  "retryAfter": 30,
  "message": "Rate limit reached, retrying in 30s"
}

​
claude:finished

Emitted when the Claude agent process exits. 
{
  "taskId": 1,
  "exitCode": 0,
  "duration": 45000
}

​
Collaboration Events

​
agent:file_conflict

Emitted when multiple agents access the same file simultaneously (specifically on Write/Edit operations). 
{
  "taskId": 5,
  "conflictingTaskId": 8,
  "filePath": "src/main.rs",
  "toolName": "Edit"
}

​
task:test_started

Emitted when auto-test verification begins. 
{ "taskId": 1 }

​
task:test_completed

Emitted when auto-test verification finishes. 
{
  "taskId": 1,
  "verdict": "approve",
  "summary": "All checks passed"
}
All events are emitted globally. Filter by projectId or taskId on the frontend to show only relevant updates.