Home› Tools› scorpiox-tasks

scorpiox-tasks core

Manage persistent tasks across complex, multi-step workflows. Create named tasks, add steps, mark completions, list progress, and switch context — all persisted to disk so nothing is lost between sessions.

linux-x64 linux-arm64 macos-arm64 windows-x64

⚡ Actions & Commands

scorpiox-tasks uses an action-based interface. Each invocation specifies an action and its parameters via JSON input.

Action Parameters Description
create text (task name) Create a new named task. Returns a unique task ID.
add task_id, text (step description) Add a step to an existing task. Returns the step ID.
complete task_id, step_id Mark a specific step as completed.
list — List all tasks with their steps and completion status.
pending — Show only tasks that have incomplete steps.
switch task_id Switch active context to a different task. Clears working context for a fresh start.

💻 Usage Examples

Create a new task for a multi-step deployment
$ scorpiox-tasks create "Deploy v2.4.0 to production"
Task created: ID 1 — "Deploy v2.4.0 to production"
Add steps to the task
$ scorpiox-tasks add --task_id 1 --text "Run test suite"
Step 1 added to task 1

$ scorpiox-tasks add --task_id 1 --text "Build release artifacts"
Step 2 added to task 1

$ scorpiox-tasks add --task_id 1 --text "Push Docker images"
Step 3 added to task 1

$ scorpiox-tasks add --task_id 1 --text "Update Kubernetes manifests"
Step 4 added to task 1
Mark steps as completed
$ scorpiox-tasks complete --task_id 1 --step_id 1
✓ Step 1 completed in task 1

$ scorpiox-tasks complete --task_id 1 --step_id 2
✓ Step 2 completed in task 1
List all tasks and their progress
$ scorpiox-tasks list
Task 1: Deploy v2.4.0 to production (2/4 steps done)
✓ 1. Run test suite
✓ 2. Build release artifacts
○ 3. Push Docker images
○ 4. Update Kubernetes manifests
Show only pending (incomplete) tasks
$ scorpiox-tasks pending
Task 1: Deploy v2.4.0 to production — 2 steps remaining
○ 3. Push Docker images
○ 4. Update Kubernetes manifests
Switch context to a different task
$ scorpiox-tasks switch --task_id 2
Switched to task 2: "Refactor auth module"
# Context window cleared — fresh start for this task
Typical AI-agent workflow — creating and tracking work
# The agent creates a task at the start of complex work
$ scorpiox-tasks create "Migrate database schema v3→v4"
Task created: ID 3

# Steps are added as the plan becomes clear
$ scorpiox-tasks add --task_id 3 --text "Backup current schema"
$ scorpiox-tasks add --task_id 3 --text "Write migration SQL"
$ scorpiox-tasks add --task_id 3 --text "Test on staging"
$ scorpiox-tasks add --task_id 3 --text "Apply to production"

# Steps are completed as work progresses
$ scorpiox-tasks complete --task_id 3 --step_id 1
# ... agent continues working ...
$ scorpiox-tasks complete --task_id 3 --step_id 2

# Even if the session is interrupted, progress is preserved on disk
$ scorpiox-tasks pending
Task 3: Migrate database schema v3→v4 — 2 steps remaining

📦 Source & Build Info

Source File
scorpiox/scorpiox-tasks.c
Lines of Code
649
Dependencies
libsxutil