> ## 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.

# Config

> Manage the local CLI configuration file (~/.crewship/cli-config.yaml) — server URL, token, default workspace, and a one-shot health check.

# crewship config

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

```bash theme={null}
crewship config <subcommand>
```

## Subcommands

| Command    | Description                                                                             |
| ---------- | --------------------------------------------------------------------------------------- |
| `show`     | Display current configuration                                                           |
| `set`      | Set a configuration value                                                               |
| `validate` | Sanity-check the saved config (token authenticates, workspace exists, server reachable) |

***

## `crewship config show`

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

```bash theme={null}
crewship config show
```

***

## `crewship config set`

Set a configuration value.

```bash theme={null}
crewship config set <key> <value>
```

**Available keys:**

| Key                                      | Description                                                                                         |
| ---------------------------------------- | --------------------------------------------------------------------------------------------------- |
| `server`                                 | Server URL (e.g., `http://localhost:8080`).                                                         |
| `workspace`                              | Default workspace slug or ID.                                                                       |
| `format`                                 | Default output format: `table`, `json`, `yaml`, or `quiet`.                                         |
| `default-agent` (alias: `default_agent`) | Default agent slug used by chat-style commands when `--agent` is omitted.                           |
| `markdown`                               | Markdown-rendering toggle for terminal output: `on`, `off`, or `auto` (auto follows TTY detection). |

```bash theme={null}
crewship config set server http://localhost:8080
crewship config set workspace my-workspace
crewship config set format json
crewship config set default-agent viktor
crewship config set markdown auto
```

***

## `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.

```bash theme={null}
crewship config validate
```

## Multiple servers

To target several instances (dev/staging/prod) from one config, use
**[server profiles](/cli/server)** 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`](/cli/server) — manage named server profiles for multi-instance targeting.
* [`crewship workspace`](/cli/workspace) — switch / list / create workspaces, manage members and invitations (moved out of this page since `config` and `workspace` are distinct surfaces).
* [`crewship login`](/cli/login) — populate `server` and `token` interactively.
* [Authentication](/guides/auth) — how the CLI token is minted and validated end-to-end.