# profiles

Use this to see what a fresh install would set up before you add anything.

Every install starts from a built-in component profile, a named bundle that marks which components are selected by default and which are left optional. `brigadestack profiles` inspects those bundles so you can see what a fresh install wires before you add sidecars. It is read-only: it lists and shows the shipped profiles and never edits config or installs anything.

## Commands

- `brigadestack profiles list` lists the built-in profiles with selected and optional component counts and a one-line summary.
- `brigadestack profiles show <profile>` shows one profile by name or alias, printing its aliases, summary, selected components, and optional components.

Both accept `--json` for machine-readable output.

```bash
brigadestack profiles list
brigadestack profiles show repo
brigadestack profiles show default        # alias of repo
brigadestack profiles list --json
```

## The built-in profiles

- `repo` (alias `default`) is the default repo workspace profile, with priority components and Scout skills selected. It selects the core sidecar set for memory, guard, security, tokens, evidence, search, and skills while leaving heavier or host-global components optional.
- `workspace` is the operator workspace profile, carrying the repo priority stack plus Scout skills and selecting `mcp` as well.
- `fleet-operator` is a read-only fleet visibility profile, and fleet-kit style automation remains optional.

```
brigade profiles:
  repo            selected=8 optional=3  - Default repo workspace profile with priority components and Scout skills selected.
  workspace       selected=9 optional=2  - Operator workspace profile with the repo priority stack and Scout skills selected.
  fleet-operator  selected=8 optional=3  - Read-only fleet visibility profile; fleet-kit style automation remains optional.
```

`profiles show` prints the selected and optional components for one profile:

```text receipt="brigadestack profiles show repo · exit 0"
profile: repo
aliases: default
Default repo workspace profile with priority components and Scout skills selected.
selected components:
  - core
  - skills
  - memory
  - guard
  - security
  - tokens
  - evidence
  - search
optional components:
  - mcp
  - pantry
  - notifications
```

An unknown profile name exits non-zero and prints `unknown profile: <name>`.

Profiles are inspection only. Use `brigadestack components list` to see the component catalog for a profile, and `brigadestack add` to wire the sidecars a profile selects.