Supastate

Persistent Memory for Claude Code

Set Up Camille in 5 Minutes

Give Claude Code a persistent knowledge graph that remembers everything, learns from mistakes, and shares knowledge across your team.

Watch the Demos

Loading player...

Quick Start Guide

Follow these steps to set up Camille and start using Supastate with Claude Code

1

Install Camille CLI

Global npm package for managing your Supastate connection

sudo npm install -g camille

Installs the Camille CLI globally on your system

Works on macOS, Linux, and Windows (via WSL)

2

Run Setup Wizard

Configure Camille with your Supastate account

camille setup

The setup wizard will:

  • •Ask for your Supastate API key (get it from dashboard settings)
  • •Configure the MCP server connection
  • •Set up local configuration files
3

Add Project Directories

Tell Camille which codebases to index and monitor

During setup, you'll be prompted to add directories. You can add:

Single Project
~/projects/my-app
Parent Directory
~/work

Recursively monitors all subdirectories

💡 Tip: You can add more directories later with camille server add-directory ~/new-project

4

Start the Camille Server

Launch the local MCP server that connects to Supastate

camille server start

Starts the MCP server on your local machine

Watches for file changes in real-time

Captures Claude Code conversations automatically

5

Wait for Initial Synchronization

Camille will index your code and build the knowledge graph

Initial indexing takes 5-30 minutes

Depends on codebase size. Progress shown in terminal.

What happens during sync:

  • ✓ Parses all code files and extracts entities
  • ✓ Generates AI embeddings for semantic search
  • ✓ Builds relationship graph between code elements
  • ✓ Indexes existing Claude conversations (if any)
6

Add Supastate Tools to Your Project

Configure Claude Code to use Supastate MCP tools

Add this to your project's CLAUDE.md file:

# CLAUDE.md - Project Instructions

## 🚨 MANDATORY: USE SUPASTATE MCP TOOLS FIRST!

**BEFORE DOING ANYTHING**, you MUST use these tools IN ORDER:
1. **supastate_restore_context** - Get full context about the topic
2. **supastate_check_before_implementing** - Check for existing solutions
3. **search** / **searchCode** / **searchMemories** - Find related code and discussions

**NEVER WRITE CODE WITHOUT CHECKING EXISTING SOLUTIONS FIRST!**

## Essential Workflow
- Start every task with: supastate_restore_context
- Before coding: supastate_check_before_implementing
- During development: supastate_record_learning
- For debugging: supastate_rubber_duck
- Save decisions: supastate_preserve_critical_context

You're All Set! 🎉

Claude Code now has persistent memory through Supastate. Every conversation, decision, and lesson learned will be remembered forever.

Common Camille Commands

💡 Tip: Logs are stored in ~/.camille/logs

Server Management

camille server startStart server
camille server stopStop server
camille server statusCheck status

Directory Management

camille server add-directory [path]Add directory
camille server remove-directory [path]Remove directory
camille server reindex-edgesRe-parse files
camille server restartRestart server

Need Help?