Skip to content

Commit 7eb8f4d

Browse files
docs: GitCafe writes sync too; only PR creation must be on GitHub
Co-Authored-By: Claude Opus 5.5 <[email protected]>
1 parent 2b4e9df commit 7eb8f4d

2 files changed

Lines changed: 13 additions & 11 deletions

File tree

‎AGENTS.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -139,7 +139,7 @@ For authorized mobile verification, a missing or outdated native client is a bui
139139
## Pull requests
140140

141141
- Never make a PR unless the developer explicitly asks you to do so.
142-
- If `origin` is git.cafe, follow [GitCafe mirror](docs/operations/development.md#gitcafe-mirror-optional): read through `cafe`, but push and open PRs on GitHub, where CI runs.
142+
- If `origin` is git.cafe, follow [GitCafe mirror](docs/operations/development.md#gitcafe-mirror-optional): use `cafe` for PRs, issues, comments and labels, but push and open PRs on GitHub, where CI runs.
143143
- Conventional commit titles, plain language: `fix(web): new threads no longer spike CPU`.
144144
- Body: the problem in a sentence or two, then how you fixed it. End with the model and harness that did the work.
145145
- UI changes need before/after images. Motion or timing needs a short video.

‎docs/operations/development.md‎

Lines changed: 12 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -21,8 +21,9 @@ GitHub is the source of truth. [git.cafe/pingdotgg/t3code](https://git.cafe/ping
2121
two-way synced mirror with much higher API rate limits, which helps when many agents read PRs and
2222
issues at once. You never need it to contribute.
2323

24-
The mirror has no CI, so it is for reads only. Fetch and read through GitCafe; push and open PRs on
25-
GitHub, and GitCafe mirrors them within about a minute.
24+
Comments, reviews, labels, and issue edits made on GitCafe sync back to GitHub. The exception is
25+
code: CI runs only on GitHub, so push branches and open PRs there. GitCafe mirrors a new PR within
26+
about a minute, and from then on you can work with it through either forge.
2627

2728
```sh
2829
git remote set-url origin https://git.cafe/pingdotgg/t3code.git
@@ -36,17 +37,18 @@ cafe skills install --global # optional: cafe-* skills for coding agents
3637

3738
With `origin` on git.cafe:
3839

39-
- Read PRs, issues, comments, reviews, and check status with `cafe`; checks come from
40-
`cafe pr status <n> --json`.
41-
- Push, open PRs, run stacks, and merge on GitHub: `git push` (via `pushDefault`), `gh pr create`,
42-
`gh stack`, `gh pr merge <branch> --match-head-commit <sha>`. Never `cafe pr create` or
43-
`cafe stack submit`: those PRs get no CI.
44-
- Use `gh` for what the mirror lacks: CI logs and reruns, PR labels, a fork PR's head repository,
45-
and anything `cafe` returns empty or 403/404 for.
40+
- Use `cafe` for PRs, issues, comments, reviews, and labels, both reading and writing. Check status
41+
comes from `cafe pr status <n> --json`.
42+
- Create PRs on GitHub: `git push` (to the `pushDefault` remote), then `gh pr create` or `gh stack`.
43+
Never `cafe pr create` or `cafe stack submit`, because those PRs get no CI.
44+
- Merge with `gh pr merge <branch> --match-head-commit <sha>`. `cafe pr merge` has no head lock.
45+
- Use `gh` where the mirror falls short: CI logs and reruns, a fork PR's head repository, and
46+
anything `cafe` returns empty or 403/404 for.
4647
- PR and issue numbers can differ between the forges. Name PRs by branch
4748
(`cafe pr list --head <branch>`, `gh pr view <branch>`), and write `Fixes #<GitHub number>`.
4849
- `cafe` flags differ from `gh`: `--repo` not `-R`, `cafe issue comments <n>` not `--comments`,
49-
`cafe pr status` not `pr checks`. `cafe ci` covers GitCafe Actions only, so it is empty here.
50+
`cafe pr status` not `pr checks`. `cafe ci` only lists GitCafe Actions runs, which this repo
51+
doesn't have, so it comes back empty here. `cafe api` paths omit `/api` (`cafe api /repos/...`).
5052

5153
## Choosing a dev process
5254

0 commit comments

Comments
 (0)