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 approvals
Manage the Harbor Master approval queue. list is safe for any workspace member; approve and deny require OWNER or ADMIN role server-side (403 otherwise).
crewship approvals <subcommand> [flags]
Subcommands
| Command | Description |
|---|
list | List approval requests. |
get <id> | Fetch a single approval request with full detail. |
approve <id> | Approve a pending request. |
deny <id> | Deny a pending request. |
reset-auto-tuning <tool> | Wipe rolling reward history for a tool to re-train gate auto-tuning. |
cancel is deliberately absent — the backend does not expose POST /api/v1/approvals/{id}/cancel yet.
crewship approvals list
crewship approvals list # pending only (default)
crewship approvals list --status approved --limit 100
crewship approvals list --status all # full history
| Flag | Type | Default | Description |
|---|
--status | string | pending | One of pending, approved, denied, timeout, cancelled, all. |
--limit | int | 50 | Max rows (server caps at 200). |
req_01HXYZABCDEF [pending ] destructive_op backend-team viktor rm -rf /data/*
req_01HXYZGHIJKL [approved] cost_threshold backend-team eva Claude Opus 4.7 $7.20 estimate
req_01HXYZMNOPQR [denied ] target_environm platform oliver ssh ops@prod-db-01
crewship approvals approve <id>
crewship approvals approve req_01HXYZABCDEF --comment "reviewed with staging validation"
| Flag | Type | Default | Description |
|---|
--comment | string | | Optional comment recorded with the decision. |
✓ Approval req_01HXYZABCDEF: approved (by user_123)
crewship approvals deny <id>
crewship approvals deny req_01HXYZABCDEF --comment "wrong mission target"
| Flag | Type | Default | Description |
|---|
--comment | string | | Optional comment recorded with the decision. |
crewship approvals get <id>
Fetch one approval request and render its full detail (kind, args, reason, decision metadata). The entry is workspace-scoped — IDs from other workspaces return 404.
crewship approvals get apr_abc123
crewship approvals get apr_abc123 --format json | jq .args
id, status, kind, reason, crew_id, agent_id, mission_id, requested_by, decided_by, decided_at, comment, created_at, updated_at) up top, then any extra keys verbatim so an evolving server payload still renders something useful.
Wipe the reward history used by Harbor Master gate auto-tuning for the given tool. Auto-tuning downgrades sync→async after 90%+ approvals and upgrades async→sync after 70%+ denials, over the last 20 decisions per tool+args shape. When that window gets skewed (e.g. automation approving on humans’ behalf for a stretch), reset to make the gate respect the configured mode again until humans re-train it naturally.
Requires OWNER or ADMIN on the caller’s workspace.
crewship approvals reset-auto-tuning shell.exec
crewship approvals reset-auto-tuning "terraform apply"
rows_deleted from gate_reward_history.
Errors
| Exit | Meaning |
|---|
| 401 | Not authenticated. Run crewship login. |
| 403 | Logged in but not OWNER or ADMIN. |
| 404 | Request ID not found in your workspace. |
| 409 | Request already decided (status is no longer pending). |
