⌘K
DocsDeveloper reference

Tasks

Fire-and-forget work: each task builds in its own isolated workspace, merges back, and ships through your release checks.

Launch a task

Hands the agent a tracked task — no open session needed. The task builds in an isolated workspace and auto-promotes once the repository's release checks pass.

spaceboy task "Add a pricing page" --project prj_...
spaceboy task "..." --project prj_... --wait # exit 0 = completed

List tasks

Active tasks — organization-wide, or scoped to one project.

spaceboy tasks list [--project prj_...]

Inspect a task

One task's full picture: status, stage, result summary, agent narration, and the event timeline — including the post-merge CI verdict.

spaceboy tasks show <taskId>

Watch a task to completion

Follows a task until it finishes. The CLI and SDK poll for you and succeed only when the task completes, so scripts and agents can chain on success.

spaceboy tasks watch <taskId> [--timeout 30]
How tasks work