succ
Open Source|FSL 1.1
Cloud coming soon
succ

Semantic Understanding for Code Contexts

Persistent semantic memory for Claude Code. 40+ MCP tools, knowledge graph, code search with tree-sitter AST, and working memory that never forgets.

View on GitHubGet Started
Open Source
|MCP Native|TypeScript

Core Capabilities

Long-term memory for your AI assistant

succ turns ephemeral AI conversations into persistent, interconnected knowledge. Every decision, pattern, and lesson is preserved, scored, and retrievable.

Working Memory
Pinned memories, priority scoring with confidence decay, and diversity filtering. Your AI assistant loads the most important context at every session start.
Hybrid Search
BM25 keyword search combined with semantic vector similarity. Search memories, brain vault docs, and source code with a single query.
Code Intelligence
Tree-sitter AST parsing for 13 languages. Extract functions, classes, and symbols. Search code by meaning, regex, or symbol type.
Knowledge Graph
Memories are linked with typed relationships. Community detection, centrality scoring, and automatic relationship enrichment build a web of understanding.
Brain Vault
Persistent knowledge base organized as Obsidian-compatible markdown. Indexed, searchable, and automatically enriched with wikilinks and metadata.
Session Continuity
Auto-loads context at session start, precomputes briefings during idle time, and hands off state between sessions. No memory loss between conversations.

MCP Tools

40+ tools your AI assistant can use

Every tool is available via Model Context Protocol. Claude Code discovers and uses them automatically — no manual configuration needed.

Memory

succ_remember

Store memories with auto-tagging, quality scoring, and invariant detection

succ_recall

Hybrid search across memories with temporal filtering and dead-end boost

succ_forget

Delete memories by ID, age, or tag with pinned memory protection

succ_dead_end

Record failed approaches to prevent repeating mistakes

Search

succ_search

Search brain vault docs with hybrid BM25 + semantic similarity

succ_search_code

Search source code by meaning, regex, or symbol type across indexed files

succ_symbols

Extract AST symbols via tree-sitter (functions, classes, interfaces, types)

Knowledge Graph

succ_link

Create, delete, and visualize links between memories and concepts

succ_explore

Traverse knowledge graph from any memory with configurable depth

Indexing

succ_index_file

Index markdown docs into brain vault for semantic search

succ_index_code_file

Index source files with AST chunking for code search

succ_analyze_file

Generate brain vault documentation from source files

succ_reindex

Detect stale files, re-index modified, clean deleted entries

PRD Pipeline

succ_prd_generate

Generate product requirement docs with quality gates

succ_prd_run

Execute PRDs with branch isolation and checkpoint tracking

succ_prd_status

Track PRD progress, feature completion, and gate results

System

succ_status

Indexed docs, code files, memory count, daemon status

succ_score

AI-readiness score for your project

succ_config

View and set configuration (storage backend, embedding model, etc.)

succ_debug

Structured debugging sessions with hypothesis testing

succ_web_search

Perplexity-powered web search with cost tracking

Quick Start

Three steps to persistent memory

Get succ running in under a minute. No accounts required. API keys optional for advanced features.

01

Install and initialize

One command installs succ globally. Then run succ init in your project to set up MCP server, session hooks, and local storage.

terminal
# Install globally
npm install -g @vinaes/succ

# Initialize in your project
cd my-project
succ init

# That's it. succ is now:
#   MCP server registered in Claude Code
#   Session hooks installed
#   Daemon running in background
#   Ready to remember
02

Store knowledge naturally

Tell Claude to remember decisions, patterns, or lessons. succ scores quality, detects invariants, builds embeddings, and links related knowledge automatically.

claude code session
> "Remember: our API always uses cursor-based
   pagination, never offset-based"

succ_remember:
  id:          12847
  type:        decision
  tags:        [api, pagination, cursor]
  quality:     0.82
  invariant:   true  (detected "always/never")
  links:       2 related memories found
03

Recall with full context

succ searches memories, brain vault, and source code using hybrid BM25 + semantic search. Your AI assistant recalls decisions, patterns, and code with full relationship context.

claude code session
> "How did we handle pagination?"

succ_recall (3 results, 12ms):
  [decision] API uses cursor-based pagination
    score: 0.91 | pinned | tags: api, cursor
    linked: rate-limiting, auth-tokens

  [pattern] Cursor encoding uses base64
    score: 0.74 | tags: api, encoding

  [learning] Offset pagination breaks on
    concurrent writes — switched to cursor
    score: 0.68 | tags: api, migration

Architecture

Designed for developer trust

succ is built on principles that matter to developers: privacy, performance, and complete control over your data.

succ Architecture
Claude Code / AI Assistant
|
MCP Protocol (40+ tools)
|
succ Daemon
Embedder
AST Parser
Graph
Search
Working Memory
Quality Scoring
Session Hooks
|
SQLite/PostgreSQL/Qdrant
Pluggable storage backends

Local-First, Scale-Ready

Starts with SQLite for zero-config setup. Scale to PostgreSQL + Qdrant when your project demands it.

Local Embeddings

ONNX Runtime with GPU auto-detection. Semantic search runs on your machine with no API calls required.

Knowledge Graph

Memories are linked in a knowledge graph with community detection, centrality scoring, and relationship enrichment.

Privacy by Default

Zero telemetry. All core features work offline. Optional web search and LLM features require explicit opt-in.

Background Daemon

Persistent daemon with REST API handles indexing, idle-time context precompute, and session handoff automatically.

Project Isolation

Each project gets its own memory space, brain vault, and knowledge graph. Global memories shared across all projects.

Community

Built in the open, shaped by developers

succ is source-available under the FSL 1.1 (Functional Source License). We welcome contributions of all kinds, from bug reports to new features to documentation improvements.

Documentation

Help improve guides, tutorials, and API docs.

Discussions

Share ideas, report issues, and request features.

Code Contributions

Fix bugs, add features, and improve the codebase.

Contribute on GitHubJoin Discussion

Released under the Functional Source License 1.1 (FSL 1.1).

Support the project

If succ has been useful in your workflow, you can support its continued development. Every contribution, no matter the size, helps keep this project alive.

Click any address to copy. Thank you for your generosity.

Your AI forgets everything.
Fix that.

One command. 40+ MCP tools. Persistent memory that survives every session, every context window, every restart.

Get StartedView Source

Works with Claude Code out of the box. No configuration needed.