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 crew
Manage crews (teams of AI agents sharing a container).
crewship crew <subcommand> [flags]
Subcommands
| Command | Description |
|---|
list | List all crews in the workspace |
get | Show crew details |
create | Create a new crew |
update | Update a crew |
delete | Delete a crew |
status | Show live crew status (agents, assignments, escalations) |
standup | Show crew standup summary (last 24h activity) |
peer-conversations | List peer conversations in a crew |
suggest | Get AI-powered crew suggestions based on a goal |
member list | List crew members |
member add | Add a user to a crew |
member remove | Remove a member from a crew |
connect | Create a connection between two crews |
disconnect | Remove a crew connection |
connections | List all crew connections in the workspace |
mcp | Show or set MCP server configuration for a crew |
config | Manage runtime configuration (devcontainer, mise, runtime image) |
provision | Trigger devcontainer provisioning |
provision status | Check provisioning status |
rebuild | Invalidate the cache and re-provision the container |
cache list | List cached devcontainer images (crewship-cache:*) |
cache prune | Remove old or unreferenced cached images |
crewship crew list
List all crews in the workspace.
Output columns: SLUG, NAME, AGENTS, NETWORK, MEMORY, CPUS
crewship crew get
Show detailed information about a crew.
crewship crew get <slug-or-id>
crewship crew create
Create a new crew.
crewship crew create --name "Backend Team" --memory-mb 4096 --cpus 2.0
| Flag | Type | Default | Description |
|---|
--name | string | (required) | Crew name. |
--slug | string | (auto from name) | Crew slug. |
--description | string | | Description. |
--color | string | | Color palette ID (e.g. blue, emerald, violet). |
--icon | string | | Lucide icon name (e.g. code, rocket). |
--memory-mb | int | | Container memory limit in MB. |
--cpus | float64 | | Container CPU limit. |
--ttl | int | 0 | Auto-stop after idle hours (0 = never stop). |
--network-mode | string | | Network policy: free or restricted. |
--allowed-domains | string | | Comma-separated allowed domains for restricted mode. |
crewship crew update
Update a crew. Only changed flags are sent.
crewship crew update <slug-or-id> --memory-mb 8192 --cpus 4.0
| Flag | Type | Default | Description |
|---|
--name | string | | Crew name. |
--description | string | | Description. |
--color | string | | Hex color. |
--icon | string | | Emoji icon. |
--memory-mb | int | | Container memory limit in MB. |
--cpus | float64 | | Container CPU limit. |
--ttl | int | -1 | Auto-stop after idle hours (0 = disable TTL). |
--network-mode | string | | Network policy: free or restricted. |
--allowed-domains | string | | Comma-separated allowed domains. Pass empty string to clear. |
crewship crew delete
Delete a crew. Prompts for confirmation.
crewship crew delete <slug-or-id>
crewship crew delete backend-team --yes
| Flag | Short | Type | Default | Description |
|---|
--yes | -y | bool | false | Skip confirmation prompt. |
crewship crew status
Show live crew status including agents, recent assignments, and open escalations.
crewship crew status <slug-or-id>
- AGENTS — all agents with their slug, role, and status
- ASSIGNMENTS (last 5) — recent task assignments with status colors
- ESCALATIONS (open) — pending or open escalations
crewship crew standup
Show crew standup summary (last 24h activity).
crewship crew standup <slug-or-id>
crewship crew standup backend-team --since 2024-01-01T00:00:00Z
| Flag | Type | Default | Description |
|---|
--since | string | (24h ago) | Show activity since (RFC3339 timestamp). |
crewship crew peer-conversations
List peer conversations in a crew.
crewship crew peer-conversations <slug-or-id>
crewship crew peer-conversations backend-team --limit 20
| Flag | Type | Default | Description |
|---|
--limit | int | 50 | Number of conversations to show. |
crewship crew suggest
Get AI-powered crew suggestions based on a goal.
crewship crew suggest --goal "Build a SaaS billing system"
| Flag | Type | Default | Description |
|---|
--goal | string | (required) | What should this crew accomplish? |
Crew Members
crewship crew member list
List members of a crew.
crewship crew member list <crew-slug-or-id>
crewship crew member add
Add a user to a crew.
crewship crew member add <crew-slug-or-id> <user-id>
crewship crew member remove
Remove a member from a crew.
crewship crew member remove <crew-slug-or-id> <member-id>
Crew Connections
Crew connections enable cross-crew task dispatch between two crews.
crewship crew connect
Create a connection between two crews.
crewship crew connect <crew-slug-A> <crew-slug-B>
crewship crew connect backend-team frontend-team --direction unidirectional
| Flag | Type | Default | Description |
|---|
--direction | string | bidirectional | Connection direction: bidirectional or unidirectional. |
crewship crew disconnect
Remove a crew connection by connection ID.
crewship crew disconnect <connection-id>
crewship crew connections
List all crew connections in the workspace.
crewship crew connections
crewship crew mcp
Show or set MCP server configuration for a crew.
# Show current config
crewship crew mcp <crew-slug>
# Set from inline JSON
crewship crew mcp <crew-slug> --set '{"mcpServers":{"github":{"command":"npx","args":["-y","@modelcontextprotocol/server-github"]}}}'
# Set from file
crewship crew mcp <crew-slug> --set-file .mcp.json
# Clear config
crewship crew mcp <crew-slug> --set ''
| Flag | Type | Default | Description |
|---|
--set | string | | Set MCP config from JSON string. Pass empty to clear. |
--set-file | string | | Set MCP config from file path. |
--set and --set-file are mutually exclusive. The JSON must contain a "mcpServers" top-level object.
crewship crew config
Manage runtime configuration for a crew — the devcontainer devcontainer.json, mise tool config, and optional runtime base image override. Together these drive what crewship crew provision builds.
# Inspect current config
crewship crew config <slug-or-id> --show
# Emit as JSON (pipe into jq / stash in a secret store)
crewship crew config <slug-or-id> --export
# Upload a devcontainer.json
crewship crew config <slug-or-id> --devcontainer ./devcontainer.json
# Upload a mise config alongside the devcontainer
crewship crew config <slug-or-id> --devcontainer ./devcontainer.json --mise ./.mise.toml.json
# Pin a custom base image instead of the default runtime
crewship crew config <slug-or-id> --runtime-image debian:bookworm-slim
# Reset everything back to defaults
crewship crew config <slug-or-id> --clear
| Flag | Type | Default | Description |
|---|
--show | bool | false | Pretty-print the current runtime configuration. |
--export | bool | false | Export runtime configuration as JSON to stdout. |
--clear | bool | false | Clear all runtime configuration (sets to NULL in the DB). |
--devcontainer | string | | Path to a devcontainer.json file to upload. |
--mise | string | | Path to a mise config JSON file to upload. |
--runtime-image | string | | Custom base image reference (e.g. debian:bookworm-slim). |
--show, --export, and --clear are read-or-reset operations; the three upload flags apply a new value. Combine upload flags in one invocation to update multiple fields atomically.
After changing runtime configuration, run crewship crew rebuild to invalidate the container cache and apply the new build.
crewship crew provision
Trigger devcontainer provisioning for a crew. Kicks off the same build pipeline the server runs when an agent first starts in a fresh workspace.
crewship crew provision <slug-or-id>
crewship crew provision status
Check provisioning status for a crew. Prints the current status, cached image tag, config hash, and resolved devcontainer config. Exit code is always 0 — branch on the Status field (ready, building, failed, not-provisioned) in downstream scripts rather than relying on the exit code.
crewship crew provision status <slug-or-id>
crewship crew rebuild
Invalidate the crew’s cached devcontainer image and re-provision. Use after changing crewship crew config values — provision alone will reuse the cached layer keyed by the old config hash.
crewship crew rebuild <slug-or-id>
crewship crew cache
Manage the devcontainer image cache shared across crews. Cache tags use the crewship-cache:* prefix and are keyed by a hash of devcontainer.json + mise config + runtime image, so two crews with identical configs share a single image.
crewship crew cache list
Output columns: TAG, SIZE, CREATED, USED BY (comma-joined list of crew slugs that reference the image — empty when unreferenced).
crewship crew cache prune
Remove old or unreferenced cached images. With no flags, defaults to --older-than 30d and leaves referenced images alone.
# Default — drop images older than 30 days, keep referenced ones
crewship crew cache prune
# Drop only images no crew currently points at
crewship crew cache prune --unused
# Tighter window
crewship crew cache prune --older-than 7d
# Scripted / CI
crewship crew cache prune --older-than 7d --force
| Flag | Type | Default | Description |
|---|
--older-than | string | 30d (when no flags set) | Remove images older than this duration (e.g. 30d, 72h). |
--unused | bool | false | Remove only images not referenced by any crew. |
--force | bool | false | Skip interactive confirmation. Required in non-TTY sessions. |
Pruning a referenced image forces the next crewship crew provision on that crew to rebuild from scratch (seconds to minutes). --force bypasses the confirmation prompt — use it only in scripts.
See also
