Skip to main content

​
crewship config

Manage CLI configuration stored in ~/.crewship/cli-config.yaml.

​
Subcommands

​
crewship config show

Display current CLI configuration including config file path, server, workspace, format, and token status.

​
crewship config set

Set a configuration value.
Available keys:

​
crewship config validate

Sanity-check the saved CLI configuration end-to-end: parse the YAML, dial the server, verify the token authenticates, and confirm the recorded workspace exists for the caller. Useful as a one-shot health check before scripting against the CLI or wiring it into CI.

​
Multiple servers

To target several instances (dev/staging/prod) from one config, use server profiles instead of swapping server/token by hand. Each profile carries its own token and is selectable per-command (--profile), per-shell (CREWSHIP_PROFILE), or per-directory. config show prints the active profile when any are defined.

​
See also

  • crewship server — manage named server profiles for multi-instance targeting.
  • crewship workspace — switch / list / create workspaces, manage members and invitations (moved out of this page since config and workspace are distinct surfaces).
  • crewship login — populate server and token interactively.
  • Authentication — how the CLI token is minted and validated end-to-end.