Skip to content

v0.1.0 — Initial Release

Choose a tag to compare

@shawnhack shawnhack released this 20 Feb 16:46
· 191 commits to main since this release

Exocortex v0.1.0

Personal AI memory system with self-improving retrieval. Local-first, SQLite-backed, MCP-native.

Highlights

Core

  • Hybrid retrieval via Reciprocal Rank Fusion (RRF) — fuses vector similarity, full-text search, and graph proximity
  • Local embeddings (all-MiniLM-L6-v2) — no external API keys required
  • Self-improving scoring — retrieval feedback loop tracks which memories prove useful, adaptive weight tuning adjusts scoring automatically
  • Store-time relation discovery — auto-links semantically similar memories at write time
  • Multi-hop context expansion — search results include 1-hop linked memories

Memory Intelligence

  • Graph-aware search with entity and memory-link proximity boosting
  • Health diagnostics (8 automated checks)
  • Search friction tracking — logs zero-result queries to identify knowledge gaps
  • Consolidation, contradiction detection, and importance recalibration
  • Entity graph with centrality analysis, community detection, and co-occurrence densification
  • Temporal evolution queries — trace how knowledge about a topic changed over time

Goal System

  • Goal tracking with milestones, priority, and deadline support
  • Autonomous goal mode — external agent systems can advance goals via MCP tools
  • Auto-detection of goal progress from incoming memories

MCP Server (26 tools)

Works with any MCP-compatible client: Claude Code, Codex CLI, Gemini CLI, GitHub Copilot.

memory_store · memory_search · memory_context · memory_get · memory_update · memory_forget · memory_browse · memory_feedback · memory_link · memory_timeline · memory_ingest · memory_digest_session · memory_consolidate · memory_maintenance · memory_graph · memory_entities · memory_ping · memory_decay_preview · goal_create · goal_list · goal_update · goal_log · goal_get · goal_add_milestone · goal_update_milestone · goal_remove_milestone

Dashboard

React + Vite web UI with search, graph visualization, timeline, entity explorer, chat (RAG-powered Q&A), and settings management.

Operations

  • Nightly SQLite backup with rotation
  • Automatic maintenance pipeline (importance adjustment, archival, entity extraction, trash purge)
  • Session-orient hook for Claude Code — auto-loads project context at session start

Setup

pnpm install
pnpm build
node packages/mcp/dist/index.js

See README for full setup instructions.