codex-flows/docs/development-flow.md

Development Flow

This monorepo is developed on Codeberg and mirrored to GitHub only for npm trusted publishing.

Remotes

Use Codeberg as the normal development remote:

git remote -v
# origin  git@codeberg.org:peezy-tech/codex-flows.git
# github  https://github.com/peezy-tech/codex-flows.git

Push ordinary development to Codeberg:

git push origin main

Push to GitHub only when a release needs the trusted publishing workflow:

git push github main

Machine Keys

This machine uses a dedicated Codeberg SSH key:

~/.ssh/id_ed25519_codeberg.pub

The public GPG key for commit verification is exported here:

~/.config/codeberg-keys/matamune-codeberg-gpg.asc

Upload both public keys to the Codeberg account before pushing over SSH or expecting verified commits.

Forgejo CLI

forgejo-cli is installed as fj.

Authenticate with Codeberg after creating an application token:

fj auth add-key <codeberg-username> <token>
fj auth use-ssh true
fj auth list

If browser login is available, this may also work:

fj auth login
fj auth use-ssh true

Releases

Release package: @peezy.tech/codex-flows

Before publishing:

bun run --filter @peezy.tech/codex-flows release:check
bun run check:types
bun run test
git diff --check

To publish through GitHub trusted publishing:

1. Bump packages/codex-client/package.json.
2. Commit and push to Codeberg.
3. Push the same commit to GitHub.
4. Run .github/workflows/publish-codex-flows.yml on GitHub with confirmation input @peezy.tech/codex-flows.
5. Verify npm:

npm dist-tag ls @peezy.tech/codex-flows