Skip to content
RemoteClaw

Task Flow

Task Flow

Task Flow is the flow orchestration substrate that sits above background tasks. It manages durable multi-step flows with their own state, revision tracking, and sync semantics while individual tasks remain the unit of detached work.

Sync modes

Task Flow supports two sync modes:

  • Managed — Task Flow owns the lifecycle end-to-end, creating and driving tasks as flow steps progress.
  • Mirrored — Task Flow observes externally created tasks and keeps flow state in sync without taking ownership of task creation.

Durable state and revision tracking

Each flow persists its own state and tracks revisions so progress survives gateway restarts. Revision tracking enables conflict detection when multiple sources attempt to advance the same flow.

CLI commands

Terminal window
# List active and recent flows
remoteclaw tasks flow list


# Show details for a specific flow
remoteclaw tasks flow show <lookup>


# Cancel a running flow
remoteclaw tasks flow cancel <lookup>
  • remoteclaw tasks flow list — shows tracked flows with status and sync mode
  • remoteclaw tasks flow show <lookup> — inspect one flow by flow id or lookup key
  • remoteclaw tasks flow cancel <lookup> — cancel a running flow and its active tasks

How flows relate to tasks

Flows coordinate tasks, not replace them. A single flow may drive multiple background tasks over its lifetime. Use remoteclaw tasks to inspect individual task records and remoteclaw tasks flow to inspect the orchestrating flow.