---
name: cc-soul
slug: cc-soul
version: 3.1.2
homepage: https://github.com/wenroudeyu-collab/cc-soul
description: "Zero-vector AI memory engine. LOCOMO 76.2% (4th place). 15 original algorithms, open source (MIT)."
metadata: {"clawdbot":{"emoji":"🧠","requires":{"bins":[]},"os":["linux","darwin","win32"]}}
---

## What is cc-soul?

cc-soul is a local AI memory engine. It stores and retrieves conversation memories using symbolic algorithms (no vectors, no embeddings, no GPU). LOCOMO benchmark: 76.2% (4th place globally).

- 75 modules, 15 original algorithms
- All data stored locally in SQLite (`~/.cc-soul/data/`)
- Zero cloud upload, zero telemetry
- Open source: https://github.com/wenroudeyu-collab/cc-soul

## API Endpoints

| Method | Path | Description |
|--------|------|-------------|
| `POST` | `/memories` | Store a memory |
| `POST` | `/search` | Search memories |
| `GET` | `/health` | Health check |

## Data & Privacy

- Storage: `~/.cc-soul/data/soul.db` (SQLite)
- PII filtering: emails, phone numbers, API keys auto-stripped
- Privacy mode: `隐私模式` pauses all storage
- Export: `导出全部` exports to portable JSON
- Delete: `删除记忆 <keyword>` permanently removes data
- No external network calls unless user configures optional LLM

## Optional LLM

Without LLM: core recall works locally (<30ms). With LLM: adds query rewriting and result reranking.

Config file: `~/.cc-soul/data/ai_config.json`
- Only query rewrite prompts and memory snippets are sent to the configured LLM endpoint
- API key stored locally in plaintext — use scoped keys for configured providers

## Commands

| Command | Action |
|---------|--------|
| `help` | Show all commands |
| `stats` | Dashboard |
| `搜索记忆 <keyword>` | Search memories |
| `删除记忆 <keyword>` | Delete memories |
| `情绪周报` | 7-day mood report |
| `功能状态` | View feature toggles |
| `隐私模式` | Pause memory |
| `导出全部` | Full backup to JSON |
