Every session starts informed.

Structured memory for AI coding.

Reccli loads project structure, session summaries, and next steps into each new coding session.

Context retrievalProject understandingSession continuity

Works with Claude Code, Cursor, and Windsurf.

Quick Start

Copy and paste the following commands one by one into your terminal (⌘ Space: Terminal) to install.

# Clone and install
git clone https://github.com/reccli/reccli.git && cd reccli && pip install -r requirements.txt
# Set up MCP server + hooks
python3 -m reccli.runtime.cli setup
# Done. Your AI now has persistent memory.

How it works

Memory that compounds

Three layers. One command. Every session starts informed.

01

Scan the codebase into structure

reccli reads your project and builds a .devproject feature map — components, dependencies, architecture. Your agent starts with a mental model instead of a blank slate.

.devprojectfeature mapproject structure
02

Reload decisions, not just files

Prior .devsession summaries, open decisions, and working context load automatically. The agent picks up where the last session left off.

session summariesdecisionsactive context
03

Memory carries over time

Each session adds to the project's memory. Structure, decisions, and context accumulate — your agent doesn't just remember the last session. It learns the project.

session 1 → session ndeeper understandingless re-explaining

The cold start problem

Every session without reccli
"This is a Next.js app with Stripe..."
"We decided to use Connect because..."
"The auth middleware is in src/..."
"Last time we fixed the webhook by..."
20 min re-explaining every time
Session #10 with reccli
Project: 8 features, 47 files
Last session: fixed webhook retry
Open issue: transfer error handling
Next step: add idempotency keys
Ready to work in 0 seconds

What It Does

Project Context

Loads your project features, folder tree, and last session summary. Every session starts informed.

Codebase Scan

Tree-sitter parses your code, LLM clusters files into features, and creates a structured project map.

Persistent Memory

Remembers decisions, problems solved, and next steps across sessions. Your context, always available.

Session Search

Hybrid search across all past sessions. "What did we decide about auth?" — answered instantly.

Exact Context

Drill into any result to see the full conversation — exact reasoning chains, not just summaries.

Open Format

.devsession and .devproject are open specs (CC0). Your data stays local. No lock-in.

Open source. Free forever.

The memory engine is MIT licensed. Team features coming soon.

AVAILABLE NOW

Open Source

$0
forever
  • MCP server for Claude Code, Cursor, Windsurf
  • Project init with Tree-sitter codebase scan
  • Cross-session memory and search
  • Hybrid retrieval (dense + BM25)
  • Open .devsession and .devproject formats
  • Local storage — your data stays yours
Install Now
COMING SOON

Team

TBD
shared project memory
  • Everything in Open Source
  • Shared .devsession history across team
  • Cross-developer session search
  • Team project dashboard
  • Hosted memory storage

Get started in 30 seconds

# 1. Clone and install
git clone https://github.com/reccli/reccli.git && cd reccli && pip install -r requirements.txt
# 2. Set up MCP server + hooks
python3 -m reccli.runtime.cli setup
# 3. Done. Your AI now has persistent memory.

Under the Hood

Built on temporal-semantic linking

Summaries link back to exact conversations through verifiable provenance, not lossy embeddings. Every decision, problem, and code change traces to the messages that produced it.

Tri-layer memory architecture

.devproject (project features) → .devsession summary (compacted working memory) → .devsession conversation (source of truth). Semantic linking between layers, temporal linking within.

Hybrid retrieval

Dense embeddings + BM25 sparse search + reciprocal rank fusion. Not just vector similarity — keyword precision when it matters.

Open formats

.devsession and .devproject are CC0-licensed specifications. JSON, human-readable, designed for any tool to implement.

FAQ

What tools does reccli work with?

Any tool that supports MCP (Model Context Protocol). Today that includes Claude Code, Cursor, and Windsurf. The list is growing — MCP is becoming the standard for tool integration.

Where is my data stored?

Locally on your machine. .devsession and .devproject files live in your project directory. Nothing is uploaded anywhere.

How is this different from CLAUDE.md?

CLAUDE.md is a static file you maintain by hand. reccli automatically builds a structured project map from your codebase, accumulates session history with searchable decisions and code changes, and loads context dynamically. It's the difference between a sticky note and a database.

Will this always be free?

The core memory engine is MIT licensed and free forever. Future team features (shared memory, cross-developer search, hosted storage) will be a paid product.