From 997a3199924afea213e7e4d90a2de4ec02c00c63 Mon Sep 17 00:00:00 2001 From: Jeroen Schweitzer Date: Wed, 11 Feb 2026 17:52:37 +0100 Subject: [PATCH] chore(meta): add tea CLI instructions to CLAUDE.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Documents non-interactive tea usage with all required flags to prevent TTY crashes in Claude Code. Agents were accessing the Gitea API directly — this standardizes on tea CLI. Co-Authored-By: Claude Opus 4.6 --- CLAUDE.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index dce2e577b..4b1fd44c1 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -71,6 +71,33 @@ db/connectors/qdrant-health db/connectors/qdrant-count ``` +### Gitea access (tea CLI) +**Never access the Gitea API directly** — use the `tea` CLI with all required flags to bypass interactive mode. + +Always pass `--login schweitz --repo jpmschweitzer/settled-reach --output simple` to avoid TTY prompts. + +```bash +# List open PRs +tea pr list --login schweitz --repo jpmschweitzer/settled-reach --state open --output simple + +# View a PR with comments +tea pr --login schweitz --repo jpmschweitzer/settled-reach --comments -o simple + +# Post a comment on a PR (or issue) +tea comment --login schweitz --repo jpmschweitzer/settled-reach "comment body" + +# Approve a PR +tea pr approve --login schweitz --repo jpmschweitzer/settled-reach + +# List issues +tea issue list --login schweitz --repo jpmschweitzer/settled-reach --state open --output simple +``` + +Key rules: +- **All flags must be explicit** — omitting `--login` or `--repo` triggers interactive prompts that crash in Claude Code (no TTY) +- **Use `--output simple`** for machine-readable output (no table borders) +- **`tea pr reject` does not work on your own PRs** — use `tea comment` instead + ### File conventions - Decisions: domain files in `decisions/` (see `decisions/README.md` for index) - Decision IDs: `D-NNN` (confirmed), `Q-NNN` (open questions), `R-NNN` (rejected)