| name | ark-resume |
| description | Switch this session's focused task to an existing active slug. Idempotent. Use when the user wants to bounce between multiple active tasks in the same checkout. |
ark-resume <task description>
Claim an existing active task as this session's focused task. After this, --slug-less commands like ark-commit resolve to the resumed slug.
Preconditions
.ark/ is initialized.- The slug exists in
.ark/.state.toml's tasks.active (created via ark-quick or ark-design, not yet archived/discarded).
Steps
Step 1: Resolve the slug [AI] [USER]
Slug is required — no default. If <task description> is empty, ask the user which active task to resume. List active tasks via ark context --scope session --format json.
Step 2: Run the op [AI]
ark agent task resume --slug <slug>
Validates the slug; sets this session's focus in .ark/.state.toml. Idempotent — re-resuming the slug already focused by this session is a no-op.
Step 3: Report [AI]
Confirm the new focus in one line. Mention any next step that depends on focus (e.g. "now ark-commit will close out <slug>").
Failure Modes
| Code | Cause | Recovery |
|---|
TaskNotFound | slug not in tasks.active (archived/discarded or typo) | Show active set via ark context; ask the user |
InvalidTaskField | slug failed validation (path traversal, whitespace, non-ASCII) | Reject with the validator's message |
See Also
workflow.md §8 (state & multi-session)ark-discard — remove an unarchived task
