@cognilabz/cognibrain
v0.1.80
Published
Self-hosted engineering memory for coding agents with a stable operator CLI, connectors and benchmark proof.
Readme
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.
Quick Start
npm i @cognilabz/cognibrain
npx cognibrain init --yes
npx cognibrain statusWhat 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
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 verifySee 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.
