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
This commit is contained in:
@@ -0,0 +1,57 @@
|
||||
# `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
|
||||
```
|
||||
Reference in New Issue
Block a user