Skip to main content

Recipe

Recipes are curated crew templates baked into the server (internal/recipes): one install atomically creates the crew, its credentials, and its MCP servers. The same catalogue powers the dashboard’s 1-click install; these commands give scripts and agents the identical flow.

crewship recipe list

List the catalogue. Machine formats (--format json|yaml|ndjson) pass the full recipe objects through.

crewship recipe get <slug>

Show one recipe’s full definition — credentials it needs (env var names, labels, types) and the MCP servers it provisions.

crewship recipe preview <slug>

Dry-run an install against the current workspace: which credentials are already present (they’ll be reused), which are still needed, and what crew slug the install will resolve to (suffixes -2/-3 when taken).
The table output ends with a ready-to-paste install command listing exactly the --credential flags still needed.

crewship recipe install <slug>

Install the recipe into the current workspace. Everything lands in one transaction — a failure at any step rolls back the whole install.
Credentials the workspace already has (matched by env var name) are reused automatically. A missing required value fails with HTTP 400 and a missing_credentials list (visible under error.extensions with --format json).

See also