How to

Start or resume work

Create or resume state for one issue, ticket, or custom work item.

What changes

start normalizes the work key, records the title and work-provider metadata, and prepares the next action for the configured delivery flow.

When this helps

A teammate or AI assistant is beginning work on a provider-backed item.
Saved state exists and needs to be resumed.
A custom or local work item needs a record before planning.

Run this command

terminal

$sumr mission start# prompt for details$sumr mission start SMR-123 --title "Improve docs"# configured issue-key prefix$sumr mission start --tracker <work-provider> --key <work-item-id> --name "Fix checkout flow" --json# explicit provider input

Flags you can use

--title <title>

Set the visible work title.

--name <title>

Alias for --title; useful when a caller sends API-style payloads.

--tracker <type>

Set a registered work provider. Read current ids with mission providers.

--provider <type>

Alias for --tracker.

--issue <id>

Provide the raw work-item number, issue key, or custom id.

--key <id>

Alias for --issue.

--allow-custom-key

Accept a work key that does not match a configured work-provider prefix. Use only for local or intentionally custom work.

--json

Return a structured JSON envelope for scripts, CI jobs, and AI assistants.

--help, -h

Show the command syntax, supported flags, and examples without changing files.