Codex Project Notes

Project

Coworker is a local-first Windows AI coding coworker. It combines a Codex-style desktop app, local model provider configuration, a persistent Brain for memory and skills, and optional iPhone/iPad PWA access.

Repository:

Code-Inc/Coworker

Stack

Electron, React, TypeScript, Vite

Package manager:

npm

Commands

Run only on Gitea Ubuntu runners:

INSTALL_COMMAND = npm install
LINT_COMMAND = npm run lint
TEST_COMMAND = npm run test
BUILD_COMMAND = npm run build
AUDIT_COMMAND = npm run audit
PACKAGE_COMMAND = npm run package:win

Local checks are limited to lightweight validation such as git diff --check.

Build Artifacts

Release artifacts are produced in:

release/

Expected files:

Coworker-Setup-<version>.exe
SHA256SUMS.txt

Security Rules

Web access is disabled by default.
LAN/PWA access requires pairing-code authentication and scoped device tokens.
Workspace tools may access only explicitly selected project directories.
Agent writes and command execution require visible user approval.
Local provider endpoints and tokens are stored in user app data, not tracked files.
Unsigned installers are acceptable until a code-signing certificate is available.

Release Rules

Before a release:

verify Gitea CI is green,
run release dry-run workflow,
confirm Coworker-Setup-<version>.exe and SHA256SUMS.txt exist,
update CHANGELOG.md and release notes,
create a v* tag,
let Gitea Actions publish the release artifact.

Do not create a release unless explicitly requested.

1.6 KiB Raw Blame History