Skip to main content

Expose

cmd/crewship/cmd_expose.go is the human side of port exposures. Agents create exposures themselves by calling the sidecar’s /expose-port endpoint; this CLI is for the audit (list) and teardown (revoke) verbs. MVP doesn’t ship approve because the default policy is open — when a future policy introduces approval, the approve verb lands here next to the others. All subcommands scope to one crew because the server enforces crew-level auth on the underlying routes.

crewship expose list

GET /api/v1/crews/{crewId}/port-expose. Columns: ID (14-char trunc), AGENT, PORT, STATUS, EXPIRES, DESCRIPTION (40-char trunc).

crewship expose revoke <id>

POST /api/v1/crews/{crewId}/port-expose/{id}/revoke. Flips an active exposure to REVOKED. Requires MANAGER+ (same as escalation resolve). Revoke prompts for confirmation (Revoke port exposure "<id>" on crew "<slug>"?) before it fires; pass --yes to skip it in scripts.
Success: Exposure <id> revoked.

See also