Files
teabot/docs/config.md
T
unkinben 1b4448afb4
ci/woodpecker/pr/test Pipeline failed
ci/woodpecker/pr/build Pipeline was successful
ci/woodpecker/pr/pre-commit Pipeline was successful
Add teabot daemon implementation
teabot watches Gitea repos and dispatches one-shot Claude Code sessions in
Docker containers to work issues and review PRs, acting as configurable bot
personalities.

Claude-Session: https://claude.ai/code/session_015ur3i7D2azsMAWTSVABApv
2026-07-26 23:36:21 +10:00

58 lines
1.6 KiB
Markdown

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