The app editorialised about its own guarantees all over the place. Removed or trimmed the clutter: - chat composer footer 'Chat is the write-path. Destructive changes are proposed, never assumed.' (removed) - Settings: dropped the 'no truth is lost' token note, the rebuildable-index / no-webhooks Sync essay (now one line about offline reads), the 'Reginald never does the arithmetic' model note, and the 'not configurable, that is the point' labels justification. - Onboarding: cut 'I never attempt the arithmetic myself', 'nothing human is lost', the 'no bot comments / only footprint' bootstrap claim, 'everything reversible', and 'Nothing more' from the token hint. - Directives: removed the 'entries are never edited, remembers everything politely' footer. - Issue detail: removed the 'lives in pm-state, your repo never sees it' note. - Calibration: cut 'never tracked'. Capture: cut 'no bot comments, your repo remains yours'. Connect: cut 'stored encrypted, never leaves it'. Functional guidance and status copy kept. desktop tsc + build clean. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
CommiTea (desktop)
An AI project manager for Gitea, as an Electron desktop app. The token stays in
the main process (OS keychain via safeStorage); the renderer never sees it.
Develop
yarn dev # electron-vite dev, HMR renderer + main (logs → desktop.log)
yarn typecheck
yarn e2e # builds, then Playwright against the built main (fixtures/demo)
For a live pass against a real Gitea, put a token in .env.local
(GITEA_TOKEN=…) and run GITEA_LIVE=1 yarn e2e live-onboarding.
Package (shareable macOS .dmg)
yarn pack # unpacked .app for the host arch (fast sanity check) → dist/
yarn dist # arm64 + x64 .dmg → dist/CommiTea-<version>[-arm64].dmg
Config is electron-builder.yml. Builds are unsigned (no Apple certs, by
decision) — electron-builder ad-hoc signs so the app can run, but it is not
notarized. Bump version in package.json for a new release; keep
electronVersion in electron-builder.yml in sync with the electron
devDependency.
Installing a shared build (teammates)
macOS Gatekeeper blocks unsigned apps on first launch. To open:
- Open the
.dmgand drag CommiTea to Applications. - In Applications, right-click CommiTea → Open, then confirm Open in the dialog. (Double-clicking the first time just shows "cannot be opened".)
- It opens to the connection screen — enter your Gitea base URL,
owner/repo, and a personal access token (repo scope). Each teammate uses their own token, so activity is attributed correctly. A model URL is optional; chat is disabled until one is configured, everything else works without it.
Grab the -arm64 dmg on Apple Silicon, the plain one on Intel.