unkinben
1b4448afb4
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
58 lines
1.7 KiB
Markdown
58 lines
1.7 KiB
Markdown
# `teabot run`
|
|
|
|
Runs the daemon in the foreground. It polls the configured repos on `poll_interval`
|
|
and dispatches Claude sessions. This is the command the systemd user unit executes.
|
|
|
|
```bash
|
|
teabot run [flags]
|
|
```
|
|
|
|
## Flags
|
|
|
|
| Flag | Default | Description |
|
|
|------|---------|-------------|
|
|
| `--once` | `false` | Run a single poll cycle then exit. Blocks until every job dispatched during the cycle finishes — ideal for testing. |
|
|
| `--log-json` | `false` | Emit structured JSON logs instead of text. |
|
|
| `--log-level` | `info` | `debug`, `info`, `warn`, or `error`. |
|
|
| `-c`, `--config` | `~/.config/teabot/config.yaml` | Config file path (inherited from the root command). |
|
|
|
|
Logs go to stderr (captured by the systemd journal). teabot handles `SIGINT`/
|
|
`SIGTERM` by stopping the poll loop and waiting for in-flight jobs to finish
|
|
before exiting.
|
|
|
|
## Examples
|
|
|
|
```bash
|
|
# One cycle, verbose, to see what would be dispatched.
|
|
teabot run --once --log-level debug
|
|
|
|
# Foreground daemon with JSON logs.
|
|
teabot run --log-json
|
|
```
|
|
|
|
## systemd (user service)
|
|
|
|
The RPM installs a user unit at `/usr/lib/systemd/user/teabot.service`.
|
|
|
|
```bash
|
|
systemctl --user daemon-reload
|
|
systemctl --user enable --now teabot
|
|
journalctl --user -u teabot -f
|
|
```
|
|
|
|
Because it is a **user** service it runs as your login user, so it inherits your
|
|
Docker access and your `~/.claude` credentials. To keep it running when you are
|
|
not logged in, enable lingering:
|
|
|
|
```bash
|
|
loginctl enable-linger "$USER"
|
|
```
|
|
|
|
## Requirements at runtime
|
|
|
|
- `docker` on `PATH` and usable by the running user.
|
|
- The configured `job_image` pullable from the registry.
|
|
- Each personality's tea config file present and readable.
|
|
- Claude credentials available (subscription `~/.claude` or an
|
|
`anthropic_api_key` in the config).
|