Cognibrain

Self-hosted engineering memory for coding agents.

Stop fixing the same agent mistake twice. Cognibrain stores durable engineering context — repo rules, reviewer corrections, failed commands, connector events, and patch evidence — then returns compact context before the next agent action.

License: MIT npm Docs

Quick Start

npm i @cognilabz/cognibrain
npx cognibrain init --yes
npx cognibrain status

What It Does

  • Durable corrections survive across agent sessions
  • Context retrieval returns relevant facts before each action
  • Action guards warn or block known-bad operations
  • Patch evidence tracks what changed, what commands ran, and why
  • 19+ connectors integrate GitHub, Jira, Slack, Sentry, and more
  • Dream cycles automatically maintain memory health

Integration Surfaces

Surface Best for
CLI Operators, CI/CD, shell scripts
MCP MCP-native agents (Codex, Cursor)
Harness CLI Any shell-capable agent or git hook
SDK/HTTP Product integrations, dashboards, custom runtimes

Documentation

📖 cognibrain.cognilabz.com

Repository Map

Path Purpose
bin/ Installable CLI entrypoints and shared runtime helpers
src/ Core memory engine, API server, connectors, and evaluators
sdk/typescript/ TypeScript SDK and connector helpers
sdk/python/ Python client package
scripts/ Internal verification, benchmark, release, and demo commands
fixtures/ Test and benchmark fixtures
templates/ Generated agent and harness configuration templates
docker/ Optional container packaging
deploy/ Optional deployment manifests
data/benchmarks/ Local benchmark source data; large/licensed JSON inputs are ignored and supplied explicitly

Contributing

git clone https://github.com/cognilabz/cognibrain.git
cd cognibrain
npm install
npm run verify

See Contributing Guide for details.

License

MIT — see LICENSE for details.

The browser Operator UI is a separately licensed commercial add-on not included in the MIT package.