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

1.6 KiB

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

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

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.

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:

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