How bassprofressor-lab/cyberbrain works
Cyberbrain is a local-first, cited memory system for AI coding agents. Users enter through the CLI, agent hooks, MCP, or the web interface; those adapters share the application composition layer, which supports note operations and retrieval. Retrieval combines word and semantic search and reports citations and caveats. Separate capabilities cover model-assisted features, policy and audit controls, and optional team collection. The README documents the product workflow and capabilities; several internal subsystem connections are not visible in the sampled code, so those links are omitted or marked unverified.
Main entry points: app.rs Application composition · mod.rs Web API · index.rs Hybrid index · main.rs CLI dispatch
Components 21
User interfaces
- CLI dispatch
crates/cyberbrain/src/main.rs - Agent hooks
crates/cyberbrain/src/hook/mod.rs - MCP server
crates/cyberbrain/src/mcp/mod.rs - Web API
crates/cyberbrain/src/serve/mod.rs - Web interface
ui/src/App.tsx
Memory and retrieval
- Application composition
crates/cyberbrain/src/app.rs - Markdown note store
crates/cyberbrain-core/src/store.rs - Code scanning
crates/cyberbrain-code/src/lib.rs - Hybrid index
crates/cyberbrain-index/src/index.rs - Vector retrieval
crates/cyberbrain-index/src/vectors.rs
Model features
- Local embeddings
crates/cyberbrain-embed/src/lib.rs - Inference client
crates/cyberbrain-llm/src/client.rs - Model features
crates/cyberbrain-llm/src/tasks.rs
Trust and compliance
- Policy controls
crates/cyberbrain-policy/src/policy.rs - Egress controls
crates/cyberbrain-policy/src/egress/mod.rs - Audit trail
crates/cyberbrain-policy/src/audit.rs
Team collection
- Hub delivery
crates/cyberbrain/src/hub/client.rs - Hub collector
crates/cyberbrain/src/hub/service.rs - Hub storage
crates/cyberbrain/src/hub/store.rs - Remote hub
Other components
- Operator or agent
Connections 23
- Operator or agent → CLI dispatch: issues commands
README.md - Operator or agent → Agent hooks: triggers events
README.md - Operator or agent → MCP server: uses tools
README.md - Operator or agent → Web API: opens page
README.md - Web API → Web interface: serves interface
README.md - CLI dispatch → Application composition: dispatches to
crates/cyberbrain/src/main.rs - Agent hooks → Application composition: adapts requests
- MCP server → Application composition: adapts requests
- Web API → Application composition: adapts requests
- Application composition → Markdown note store: reads and writes
- Application composition → Hybrid index: retrieves and updates
- Application composition → Policy controls: enforces controls
- Application composition → Audit trail: records events
- Code scanning → Hybrid index: supplies scan content
- Hybrid index → Vector retrieval: uses vectors
crates/cyberbrain-index/src/index.rs - Local embeddings → Vector retrieval: creates embeddings
- Application composition → Model features: requests model features
- Model features → Inference client: calls client
crates/cyberbrain-llm/src/tasks.rs - Inference client → Egress controls: checks permission
crates/cyberbrain-llm/src/client.rs - Policy controls → Egress controls: configures register
crates/cyberbrain-policy/src/egress/mod.rs - Hub delivery → Remote hub: delivers audit trail
README.md - Hub collector → Hub storage: collects records
- Remote hub → Hub collector: sends records