crewship mission

Manage missions — structured multi-step work plans executed by agent crews.

crewship mission <subcommand> [flags]

Subcommands

Command	Description
`list`	List all missions
`get`	Show mission details with tasks
`create`	Create a mission
`update`	Update a mission
`delete`	Delete a mission
`start`	Start a PLANNING mission (kicks off the MissionEngine DAG loop)
`resume`	Resume a FAILED mission from the point of failure
`restart`	Restart a mission from the beginning (resets all tasks)
`add-task`	Add a task to a mission
`task-update`	Update a mission task
`clone`	Clone a mission with all its tasks

`crewship mission list`

List all missions, optionally filtered by crew.

crewship mission list
crewship mission list --crew backend-team
crewship mission list --search Harborlight --limit 20 --offset 20

Flag	Type	Default	Description
`--crew`	`string`		Filter by crew slug or ID.
`--search`	`string`		Search missions by title or identifier, on the server (sent as `q`).
`--limit`	`int`	`20`	Rows per page (the server caps it at 200).
`--offset`	`int`	`0`	Skip this many rows. A human table ends with a footer such as `showing 21–40 of N · next page: --offset 40` (that one for `--offset 20`); JSON and quiet output carry no footer.

Output columns: ID, TITLE, STATUS, LEAD, TASKS, CREATED

The TASKS column shows completion as completed/total (e.g., 3/5).

`crewship mission get`

Show mission details including all tasks.

crewship mission get <id>

Accepts full mission IDs or prefix matches (minimum 8 characters). Output fields: Title, ID, Status, Lead, Description, Created, Completed. In table format, tasks are displayed below the detail view with columns: #, TASK ID, TITLE, STATUS, AGENT.

`crewship mission create`

Create a new mission.

crewship mission create --title "Deploy v2.0" --crew backend-team
crewship mission create --title "Refactor auth" --crew backend-team --lead viktor

Flag	Type	Default	Description
`--title`	`string`	(required)	Mission title.
`--description`	`string`		Mission description.
`--crew`	`string`	(required)	Crew slug or ID.
`--lead`	`string`	(auto-detected)	Lead agent slug or ID. Auto-detects the LEAD agent in the crew if omitted.

If --lead is not specified, the CLI automatically finds the LEAD-role agent in the specified crew. An error is returned if no LEAD agent exists.

`crewship mission update`

Update a mission. Only changed flags are sent.

crewship mission update <id> --title "Deploy v2.1"
crewship mission update <id> --status DONE

Flag	Type	Description
`--title`	`string`	Mission title.
`--description`	`string`	Mission description.
`--status`	`string`	Status: `PLANNING`, `IN_PROGRESS`, `DONE`, `FAILED`. `COMPLETED` is still accepted and silently normalized to `DONE` (a retired word kept only for backward compatibility — see API reference → Missions → Update Mission).

`crewship mission delete`

Delete a mission.

crewship mission delete <id>
crewship mission delete <id> --yes

Flag	Short	Type	Default	Description
`--yes`	`-y`	`bool`	`false`	Skip confirmation prompt.

Removes the mission and its tasks. Prompts for confirmation unless --yes.

`crewship mission start`

Start a PLANNING mission, kicking off the MissionEngine DAG loop.

crewship mission start <id>
crewship mission start <id> --wait
crewship mission start <id> --wait --wait-timeout 1h

The DAG engine evaluates task dependencies and dispatches ready tasks to agents. If the mission was created under an autonomy hold (see Autonomy gate on agent-driven creation) and its autonomy_gate approval is still pending, denied, cancelled, or timed out, start answers 403 regardless of who is calling — an OWNER/ADMIN must decide the hold with crewship approvals approve <id> first.

Flag	Default	Effect
`--wait`	`false`	Block and poll `GET /api/v1/crews/{crewId}/missions/{missionId}` (the same route `mission get` uses) every 2s until the mission reaches `DONE` or `FAILED`, instead of returning as soon as the start request is acknowledged. Exits non-zero on `FAILED`.
`--wait-timeout`	`30m`	Max time to block with `--wait` (`0` = forever).

`crewship mission resume`

Resume a FAILED mission from the point of failure. Only failed tasks and their dependents are reset.

crewship mission resume <id>

Reports the number of tasks that were reset.

`crewship mission restart`

Restart a mission from the beginning, resetting all tasks to PENDING.

crewship mission restart <id>
crewship mission restart <id> --yes

Flag	Short	Type	Default	Description
`--yes`	`-y`	`bool`	`false`	Skip confirmation prompt.

Resets all tasks to PENDING — completed work is discarded. Prompts for confirmation unless --yes. Use resume to restart only failed tasks.

`crewship mission add-task`

Add a task to a mission.

crewship mission add-task <missionId> --title "Write unit tests"
crewship mission add-task <missionId> --title "Deploy" --agent viktor --order 3 --depends-on <taskId1>,<taskId2>

Flag	Type	Default	Description
`--title`	`string`	(required)	Task title.
`--description`	`string`		Task description.
`--agent`	`string`		Agent slug or ID to assign.
`--order`	`int`	`0`	Task order (1-based).
`--depends-on`	`string`		Comma-separated task IDs this task depends on.

`crewship mission task-update`

Update a specific task within a mission.

crewship mission task-update <mission-id> <task-id> --status COMPLETED
crewship mission task-update <mission-id> <task-id> --title "Updated title" --assigned-agent <agent-id>

Flag	Type	Description
`--title`	`string`	New task title.
`--description`	`string`	New task description.
`--status`	`string`	New status: `PENDING`, `IN_PROGRESS`, `COMPLETED`, `FAILED`.
`--assigned-agent`	`string`	Agent ID to assign.

`crewship mission clone`

Clone a mission with all its tasks.

crewship mission clone <mission-id>
crewship mission clone <mission-id> --title "Cloned: Deploy v2.0"

Flag	Type	Default	Description
`--title`	`string`		Override title for the cloned mission.

Getting started

Sessions & identity

Agents & conversations

Crews, projects & workspaces

Missions & routines

Issues & triage

Skills & integrations

Inbox & notifications

Memory & journal

Observability

Cost & paymaster

Approvals & hooks

Configuration & system

Utilities

Mission Commands

crewship mission

Subcommands

`crewship mission list`

`crewship mission get`

`crewship mission create`

`crewship mission update`

`crewship mission delete`

`crewship mission start`

`crewship mission resume`

`crewship mission restart`

`crewship mission add-task`

`crewship mission task-update`

`crewship mission clone`

​crewship mission

​Subcommands

​crewship mission list

​crewship mission get

​crewship mission create

​crewship mission update

​crewship mission delete

​crewship mission start

​crewship mission resume

​crewship mission restart

​crewship mission add-task

​crewship mission task-update

​crewship mission clone

crewship mission

Subcommands

`crewship mission list`

`crewship mission get`

`crewship mission create`

`crewship mission update`

`crewship mission delete`

`crewship mission start`

`crewship mission resume`

`crewship mission restart`

`crewship mission add-task`

`crewship mission task-update`

`crewship mission clone`