choihyunsus

choihyunsus / soul

Public

Multi-agent session orchestrator with KV-Cache for MCP. Your AI agent never forgets.

29
7
100% credibility
Found Mar 19, 2026 at 29 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
JavaScript
AI Summary

Soul is a memory persistence server for AI coding agents that enables session handoffs, shared context, work logging, and built-in safety checks across tools like Cursor and VS Code Copilot.

How It Works

1
😩 AI Forgets Everything

Your helpful AI coding buddy starts fresh each time, forgetting past work and needing constant reminders.

2
🔍 Discover Soul

You find Soul, a simple memory saver that lets your AI remember chats, tasks, and handoffs between sessions.

3
📦 Add Soul Quickly

Install Soul into your setup with one easy step, no hassle.

4
🚀 Link to Your AI

Connect Soul to your AI tool so it gains lasting memory and built-in safety to prevent mishaps.

5
💻 Boot and Wrap Up

At each session start, tell your AI to boot and load memories; end by saving progress and todos.

🎉 AI Remembers Forever

Your AI now recalls everything, hands off tasks smoothly between helpers, and works safely like a team.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 29 to 29 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is soul?

Soul is a JavaScript MCP server that adds persistent memory to AI agents in tools like Cursor, VS Code Copilot, or Claude Desktop, so they retain context, handoffs, and work history across sessions. Agents boot with prior TODOs, entity details, and KV-cache snapshots, then end by logging immutable ledgers and updating shared boards—no more re-explaining everything. Install via npm, configure with two commands (n2_boot, n2_work_end), and store data in any synced folder like Google Drive for instant "cloud."

Why is it gaining traction?

Unlike LangGraph multi-agent GitHub repos or generic multi-agent platforms, Soul enforces deterministic memory via code, not LLM whim, slashing recap tokens from 10k+ to ~500 with progressive KV-cache levels. Ark provides always-on safety (regex blocks like rm -rf/) at zero tokens/latency, plus file ownership prevents agent collisions. Multi-agent GitHub code seekers dig its shared brain, entity tracking, and $0 cloud sync—perfect for Claude multi-agent GitHub or soul ai GitHub workflows.

Who should use this?

Backend devs orchestrating agent teams in Cursor for task handoffs, or frontend teams using Copilot for multi-agent ideation sessions where context persists. Ideal for JS-heavy MCP users building soul browser GitHub prototypes, avoiding per-session amnesia in long projects like multi-agent system GitHub experiments.

Verdict

Try it for MCP multi-agent setups—solid docs, npm-ready, and token-saving features shine despite 29 stars and 1.0% credibility signaling early maturity. Pair with mature alternatives if you need battle-tested scale, but it's a lightweight win for agent persistence now.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.