Contributing

cognitiveOS is MIT and open source. Issues and PRs are welcome on GitHub.

Build from source

git clone https://github.com/Callmedas69/cognitive-OS.git
cd cognitive-OS
npm install
npm run build        # tsup → dist/cli.js
npm test             # vitest
node dist/cli.js --help   # must list init, start, dump, check, install-skill

The CLI is TypeScript (ESM, Node >=18) with exactly three runtime dependencies: commander, @clack/prompts, and chalk. Adding a fourth is a real maintenance cost for a solo project, so it needs a strong reason. Templates live as typed string functions in src/templates/, generators in src/generators/, the five commands in src/commands/. Windows is the primary test platform, so use path.join() everywhere and write \n while parsing both \n and \r\n.

Highest-value open target

The best place to contribute is a hook implementation for Codex, bringing the same automatic session start/end state updates that Claude Code and Antigravity already have. The agent skill, keeper subagent, and routing files already ship for all four agents; Codex is the one gap left in the hook layer.

See also: Hooks · Agent Setup · The Keeper.