Works with Claude Code & Codex

Your AI Learns From
Every Correction

Turn feedback into permanent improvements. No retraining. No prompts. Just smarter AI.

Install SmartAssist See How It Works

Free · Open source · 60 seconds to install

Before SmartAssist
terminal
You: "Don't mock the database"
AI: Uses mocks anyway
You: "I said no mocks!"
AI: Still uses mocks
With SmartAssist
terminal
Session starts...
✓ Lesson #47 injected: "Use real DB, never mock"
You: "Write the test"
AI: Creates test with real database ✓
Scroll to explore
9
MCP Tools to
Manage Memory
5
Lifecycle
Hooks
467+
Tests
Passing
<100ms
Instant
Injection
BGE-M3
Production-Grade
Embeddings
How It Works

Five steps to a smarter AI

SmartAssist creates a reinforcement learning loop that turns every correction into permanent improvement.

1

Seed

Deep analysis creates architect-level lessons from your codebase

2

Inject

Dual-memory: project rules + past corrections on every prompt

3

Feedback

Give :) or :( — per-lesson Thompson Sampling learns

4

Rank

Proven lessons rank higher, bad lessons sink, new ones explore

5

Improve

Your AI gets it right the first time — loop repeats

Features

Everything you need for AI memory

A complete system that captures, stores, ranks, and retrieves project-specific knowledge.

Find the Right Lesson, Every Time

BGE-M3 + LanceDB hybrid search with cross-encoder reranking

Lessons That Prove Themselves

Per-lesson Thompson Sampling — proven lessons rank higher, new ones get fair exploration, bad ones sink automatically

Context at the Right Moment

5 lifecycle hooks inject knowledge on prompt, session start, and tool use

Full Control From Any Conversation

9 MCP tools to search, inspect, compare, and evolve lessons from any conversation

Dual-Memory Injection

MemAlign pattern: injects project rules (semantic memory) alongside past corrections (episodic memory) for richer context

Every Repo Gets Its Own Brain

Isolated lessons, vectors, and analytics per project

Deep Seed — Architect-Level Onboarding

Analyzes git history, PR reviews, configs, and code structure to create 30-80 lessons automatically — scaled to your codebase complexity

Setup Surfaces For 6 AI Agents

Claude Code, Codex, Gemini, ChatGPT, Amp, OpenCode — Claude is the most deeply validated today, and setup-agent all wires the rest.

MCP Tools

Full control over your knowledge base

Nine MCP tools let you and your AI manage lessons directly from any conversation.

rag_search
Search your project knowledge base for relevant lessons, corrections, and conventions.
> rag_search("database testing patterns")

Found 3 lessons:
  #47 Use real DB connections in tests
  #23 Prefer transactions for test isolation
  #51 Mock only external APIs
Install

Install from GitHub today.

The supported path right now is the GitHub source install. Package registries and one-line installer endpoints are not published yet.

$ pipx install git+https://github.com/jnrahme/SmartAssist.git
Then register the agent you care about:
$ smartassist setup-agent codex

Use smartassist setup for Claude Code, or smartassist setup-agent all to print/apply every supported agent adapter.

Not published yet

These install channels are still planned:

  • pipx install smartassist
  • npm install -g smartassist-memory
  • brew install smartassist-memory/tap/smartassist
  • curl -fsSL https://smartassist-memory.com/install | sh

Use the GitHub install tab today. This panel will be updated when a package channel is actually live.

$ git clone https://github.com/jnrahme/SmartAssist.git
Then run:
$ cd SmartAssist && pipx install .

Best for local development and testing SmartAssist from a checkout before package channels are published.

$ pipx install git+https://github.com/jnrahme/SmartAssist.git
Then run:
$ cd my-project && smartassist setup

This is the supported install path today. For extra agents after install, use smartassist setup-agent <agent>.

Supported today: GitHub source install · Python 3.10+ · Project-scoped setup for Claude Code plus adapter setup for other agents

Register with any AI agent

Claude: smartassist setup
Codex: smartassist setup-agent codex
Gemini: smartassist setup-agent gemini
ChatGPT: smartassist setup-agent chatgpt
Amp: smartassist setup-agent amp
OpenCode: smartassist setup-agent opencode

All agents get the same MCP tools and learning loop. Claude Code gets the richest experience with automatic hook injection on every prompt.

Stop Repeating Yourself to Your AI

Install SmartAssist and make every project smarter from day one.

Install SmartAssist

BUSL-1.1 licensed · Works with Claude Code, Codex, Gemini, ChatGPT, Amp, and OpenCode