diff --git a/CLAUDE.md b/CLAUDE.md
index dce2e577b..41a4d6f7d 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -82,7 +82,22 @@ db/connectors/qdrant-count
 Use conventional commits with project-specific scopes:
 `agents`, `skills`, `docs`, `briefings`, `discussions`, `schema`, `db`, `config`, `engine`, `simulation`, `client`, `ui`, `audio`, `assets`, `meta`
 
+### Pull requests
+**Use `tea` (Gitea CLI), not `gh` (GitHub CLI).** The remote is Gitea at `git.schweitz.internal`.
+
+Always provide all required flags to ensure non-interactive execution:
+```bash
+tea pr create \
+  --repo jpmschweitzer/settled-reach \
+  --login schweitz \
+  --title "feat(scope): short description" \
+  --description "PR body here" \
+  --base main \
+  --head branch-name
+```
+
 ### Local services
+- Gitea: `http://git.schweitz.internal` (login: `schweitz`)
 - Qdrant: `http://tower-of-joy:6333/`
 - Ollama: `http://tower-of-joy:11434/` (nomic-embed-text)
 - Collection: `commonwealth` (768 dimensions, cosine distance)