Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.crewship.ai/llms.txt

Use this file to discover all available pages before exploring further.

crewship mission

Manage missions — structured multi-step work plans executed by agent crews.
crewship mission <subcommand> [flags]

Subcommands

CommandDescription
listList all missions
getShow mission details with tasks
createCreate a mission
updateUpdate a mission
deleteDelete a mission
startStart a PLANNING mission (kicks off the MissionEngine DAG loop)
resumeResume a FAILED mission from the point of failure
restartRestart a mission from the beginning (resets all tasks)
add-taskAdd a task to a mission
task-updateUpdate a mission task
cloneClone 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
FlagTypeDefaultDescription
--crewstringFilter by crew slug or ID.
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
FlagTypeDefaultDescription
--titlestring(required)Mission title.
--descriptionstringMission description.
--crewstring(required)Crew slug or ID.
--leadstring(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 COMPLETED
FlagTypeDefaultDescription
--titlestringMission title.
--descriptionstringMission description.
--statusstringStatus: PLANNING, IN_PROGRESS, COMPLETED, FAILED.

crewship mission delete

Delete a mission. Prompts for confirmation.
crewship mission delete <id>
crewship mission delete <id> --yes
FlagShortTypeDefaultDescription
--yes-yboolfalseSkip confirmation prompt.

crewship mission start

Start a PLANNING mission, kicking off the MissionEngine DAG loop.
crewship mission start <id>
The DAG engine evaluates task dependencies and dispatches ready tasks to agents.

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. Prompts for confirmation.
crewship mission restart <id>
crewship mission restart <id> --yes
FlagShortTypeDefaultDescription
--yes-yboolfalseSkip confirmation prompt.

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>
FlagTypeDefaultDescription
--titlestring(required)Task title.
--descriptionstringTask description.
--agentstringAgent slug or ID to assign.
--orderint0Task order (1-based).
--depends-onstringComma-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>
FlagTypeDefaultDescription
--titlestringNew task title.
--descriptionstringNew task description.
--statusstringNew status: PENDING, IN_PROGRESS, COMPLETED, FAILED.
--assigned-agentstringAgent 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"
FlagTypeDefaultDescription
--titlestringOverride title for the cloned mission.