mcp server
cognibrain
Self-hosted engineering memory for coding agents with CLI, MCP, proof gates and benchmark artifacts.
Set up
Runs on your computer. Pick your agent and operating system.
Before you start
- Node.js 20 or newer
{
"mcpServers": {
"cognibrain": {
"command": "npx",
"args": [
"-y",
"@cognilabz/cognibrain"
]
}
}
}same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12
Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs
README
synced Oct 21, 2026Cognibrain
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 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
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.