From 6ca35e2112708bdb9594fff271d70122d606e14f Mon Sep 17 00:00:00 2001 From: Jan Novak Date: Tue, 5 May 2026 22:41:05 +0200 Subject: [PATCH] docs: Encourage tea CLI for opening MRs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Replaces the "do not use tea/gh/Gitea API" rule with explicit guidance to run `tea pr create` and print the resulting PR URL. tea is already authenticated on this machine. Merging stays a manual user action in Gitea — neither tea nor git CLI may merge or delete branches. Co-Authored-By: Claude Opus 4.7 --- CLAUDE.md | 23 +++++++++++++++++------ 1 file changed, 17 insertions(+), 6 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 870fbdb..776cf66 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -105,12 +105,23 @@ request flow: 2. **Commit on the branch** following the existing commit conventions (Co-Authored-By trailer, etc.). 3. **Push the branch** to `origin` with `-u` so it tracks. -4. **Print the Gitea compare URL** so the user can open the MR in the browser: - `https://gitea.home.hrajfrisbee.cz/kacerr/fuj-management/compare/main...` - Do **not** use `tea`, `gh`, or call the Gitea API — the user opens and - merges the MR themselves. -5. **Do not merge or delete the branch** from the CLI. The user does that - in Gitea. +4. **Open the MR with `tea`** rather than printing a compare URL: + + ```bash + tea pr create \ + --title "" \ + --description "" \ + --base main \ + --head + ``` + + `tea` is already authenticated against the Gitea instance; just run it. + Print the resulting PR URL for the user. If `tea` is unavailable for + some reason, fall back to printing the compare URL + (`https://gitea.home.hrajfrisbee.cz/kacerr/fuj-management/compare/main...`) + and let the user open the MR manually. +5. **Do not merge or delete the branch** from the CLI — neither via `tea`, + `gh`, nor `git push --delete`. The user does that in Gitea. **Exceptions — when committing straight to `main` is fine:** - Small bug fixes / hotfixes the user describes as such.