Crate subcog 

Subcog

A persistent memory system for AI coding assistants. Persistent memory system for AI coding assistants.

Subcog captures decisions, learnings, and context from coding sessions and surfaces them when relevant through semantic search.

Features

• Single-binary distribution (<100MB, <10ms cold start)
• Three-layer storage architecture (Persistence, Index, Vector)
• Pluggable backends (SQLite+usearch, PostgreSQL+pgvector)
• MCP server integration for AI agent interoperability
• Claude Code hooks for seamless IDE integration
• Semantic search with hybrid vector + BM25 ranking

Example

use subcog::{CaptureService, CaptureRequest, Namespace};

let service = CaptureService::new(config)?;
let result = service.capture(CaptureRequest {
    namespace: Namespace::Decisions,
    content: "Use PostgreSQL for primary storage".to_string(),
    ..Default::default()
})?;

Re-exports

pub use config::FeatureFlags;

pub use config::OperationTimeoutConfig;

pub use config::OperationType;

pub use config::SubcogConfig;

pub use embedding::Embedder;

pub use llm::LlmProvider;

pub use models::CaptureRequest;

pub use models::CaptureResult;

pub use models::DetailLevel;

pub use models::Domain;

pub use models::Memory;

pub use models::MemoryId;

pub use models::MemoryStatus;

pub use models::Namespace;

pub use models::SearchFilter;

pub use models::SearchMode;

pub use models::SearchResult;

pub use services::CaptureService;

pub use services::ConsolidationService;

pub use services::ContextBuilderService;

pub use services::RecallService;

pub use services::SyncService;

pub use storage::CompositeStorage;

pub use storage::IndexBackend;

pub use storage::PersistenceBackend;

pub use storage::VectorBackend;

Modules

cli

CLI command implementations.

config

Configuration management.

context

Context detection for git repositories.

embedding

Embedding generation.

gc

Garbage collection module.

git

Git operations.

hooks

Claude Code hooks.

io

Import/Export I/O subsystem.

llm

LLM client abstraction (DOC-H3).

mcp

MCP server implementation.

models

Data models for subcog.

observability

Observability and telemetry.

rendering

Template rendering engine.

security

Security features.

services

Business logic services.

storage

Storage layer abstraction.

webhooks

Webhook event notification system.

Enums

Error

Error type for subcog operations.

Functions

current_timestamp

Returns the current Unix timestamp in seconds.

Type Aliases

Result

Result type alias for subcog operations.