# `teabot config`

Inspect and scaffold teabot configuration.

## `teabot config init`

Writes a fully-commented example config to the `--config` path (default
`~/.config/teabot/config.yaml`).

```bash
teabot config init            # writes ~/.config/teabot/config.yaml
teabot config init --force    # overwrite an existing file
teabot config init -c ./my.yaml
```

It refuses to overwrite an existing file unless `--force` is given. After
writing, edit the file and create the tea config files each personality
references (see [configuration](configuration.md)).

## `teabot config show`

Loads, validates, and prints the effective configuration — defaults applied and
each personality resolved from its tea config (username shown, token never
printed). A validation error here means `teabot run` would fail too, so this is
the quickest pre-flight check.

```bash
teabot config show
```

Example output:

```
config:         /home/ben/.config/teabot/config.yaml
gitea_url:      https://git.unkin.net
state_dir:      /home/ben/.local/state/teabot
poll_interval:  1m0s
job_timeout:    30m0s
max_concurrent: 2
job_image:      git.unkin.net/unkin/agent-dev:latest
claude_config:  /home/ben/.claude
repos:
  - unkin/teabot
personalities:
  - implementer (role=implementer, login=teabot-implementer)
  - reviewer (role=reviewer, login=teabot-reviewer)
```

## Shell completions

teabot uses cobra, which provides a `completion` subcommand. The RPM installs
bash/zsh/fish completions to the standard system paths automatically. To load
ad-hoc:

```bash
source <(teabot completion bash)   # or zsh / fish
```