FabricFabricHarness
CLI

Tasks

Inspect, cancel, and manage durable child tasks.

A task in Fabric Harness is a child or delegated agent run, typically started via session.task() from agent code. Task state is persisted alongside the parent session and exposed via the CLI.

fh tasks

fabric-harness tasks <session-id> [--json]

List durable tasks for a session: id, status, start/end time, parent prompt, and result (if completed).

fh task

fabric-harness task <session-id> <task-id> [--json]

Show the status, checkpoints, and metadata of a single task.

fh cancel-task

fabric-harness cancel-task <session-id> <task-id> [--actor <id>] [--reason <text>]

Append a cancellation marker so the running task observes the cancel and exits at its next checkpoint.

fh cancel-task ask-1f4f... task-2 --actor preetham --reason "Replaced by manual fix"

fh checkpoints

fabric-harness checkpoints <session-id>

List checkpoints inside a session. Checkpoints are explicit save points created via session.checkpoint.create({ label }). When the sandbox supports snapshots, a checkpoint may include a sandbox snapshot reference.

See also