sprintsai/tasks

Run this command to list tasks from Lightsprint. By default, only root tasks (no parent) are shown — subtasks are excluded.

lightsprint tasks $ARGUMENTS

Usage: tasks [--status <status>] [--complexity <level>] [--assignee <name>] [--mine] [--unassigned] [--deps <filter>] [--project <filter>] [--stack <ref>] [--sort <field>] [--limit N] [--offset N]

Flags

| Flag | Default | Description | |------|---------|-------------| | --status <status> | all | Filter by status (comma-separated): backlog, todo, in_progress, in_review, done. Example: --status todo,in_progress | | --complexity <level> | all | Filter by complexity: low, medium, or high. | | --assignee <name> | all | Filter by assignee name or email (case-insensitive substring match). | | --mine | — | Show only tasks assigned to the current user. | | --unassigned | — | Show only tasks with no assignee. | | --deps <filter> | all | Filter by dependencies: has-dependencies, has-no-dependencies, has-dependents, unblocked. | | --project <filter> | all | Filter by project. Comma-separated project IDs, or none for tasks without a project. Use lightsprint projects to list available project IDs. | | --stack <ref> | all | Filter by stack. Accepts a stack ID, task prefix, or name. Use lightsprint stacks to list available stacks. | | --sort <field> | position | Sort order: position (board order), updated_at (most recently updated first), created_at (newest first). | | --limit N | 20 | Maximum number of tasks to return (server max: 100). | | --offset N | 0 | Skip first N tasks (for pagination). | | --page-all | — | Stream all tasks as NDJSON (one JSON object per line). Ignores --limit/--offset. | | --output json | text | Return structured JSON instead of human-readable text. |

Dependency filters

• has-dependencies — tasks that depend on other tasks
• has-dependents — tasks that block other tasks
• has-no-dependencies — tasks that have no dependencies at all
• unblocked — tasks with no dependencies, or all dependencies are done

Output

For each task shows: display ID (e.g. LIG-003), status, assignee, complexity, project (if assigned), title, and first 120 chars of description.

Examples

lightsprint tasks --status todo,in_progress --mine
lightsprint tasks --status backlog --unassigned --complexity low
lightsprint tasks --deps unblocked --status todo
lightsprint tasks --project none --status todo
lightsprint tasks --project <projectId> --mine
lightsprint tasks --stack ENG --status todo

Stacks

Tasks live in stacks within the active workspace. List stacks with lightsprint stacks, inspect one with lightsprint stacks get <stackId|prefix|name>, and scope this command to a stack with --stack <ref> (stack ID, task prefix, or name).

Invariants

• This is a read-only command — it does not modify any tasks
• All flags can be combined to narrow results
• After reviewing, claim a task with /lightsprint:claim <taskId> or view details with /lightsprint:get <taskId>
• Only root tasks (tasks with no parent) can be claimed. Subtasks cannot be claimed directly.