The first agent-native memory system. A full brain architecture for AI.
English | 中文
Your AI doesn't remember you.
Every conversation starts from zero. You re-introduce yourself. You re-explain your project. You re-describe your preferences. The thing you spent an hour figuring out yesterday? Gone. The decision you made last week? Never happened.
And it's not just forgetting between sessions. Chat long enough and the context fills up — your AI starts repeating itself, getting confused, forgetting things you said 20 minutes ago. You restart. Everything you built up is gone.
Worse: your memories are scattered. Claude Code's auto-memory is a flat file that gets messy over time. Cursor's memory lives in .cursorrules and breaks across projects. Every tool remembers its own fragments, but nothing holds the full picture of you.
What if your AI actually knew you — and that knowledge was yours forever?
Loci gives your AI a real brain. Everything it learns about you is saved as plain Markdown files on your machine. No server, no subscription, no lock-in. Your memories belong to you.
Day 1: "I'm a frontend developer. I prefer simple solutions
over clever ones. I'm building a fitness app."
Your AI remembers. Permanently.
Week 2: Context is full. AI is slowing down. You restart.
"Pick up where I left off."
"You were building the workout tracker. You decided on
a card layout because of mobile. The exercise list is
done. Next up: the timer component. Ready?"
Month 3: You open a completely different project.
"How should I structure this?"
"Based on what I know about you: you like flat folder
structures, you always regret adding too many abstractions
early, and you prefer starting with a working prototype.
Here's what I'd suggest..."
The longer you use it, the better it knows you. Your preferences, your patterns, your growth — across every conversation, every project, every context reset. It never forgets, and it never disappears.
Your AI is no longer a stranger. It's the one assistant that actually knows who you are.
- It's yours. Every memory is a file on your machine. No server, no subscription. Cancel anything, switch any tool — your brain stays with you.
- It's private. Your identity, your decisions, your goals — stored locally. No one else can see it. Not even us.
- It grows with you. Day one, it knows your name. Month three, it knows your patterns. Year one, it can tell you how you've changed.
- It never crashes. Session dies? Context full? Computer restarts? Save and recover in 10 seconds. Your AI picks up exactly where you left off.
- It collects for you. Toss in an article, a link, a half-formed idea. Forget about it. Weeks later, when it's relevant, your AI surfaces it at exactly the right moment.
CLAUDE.md is a sticky note. Loci is a second brain.
- CLAUDE.md is one file. Loci is 30+ structured modules — identity, decisions, tasks, daily plans, journal, evolution — that stay clean no matter how much you use them.
- CLAUDE.md is per-project. Loci connects all your projects. A lesson you learned in Project A becomes a warning in Project B — automatically.
- CLAUDE.md degrades with use. The file grows, context bloats, AI slows down. Loci uses layered loading — only relevant memory enters context. Heavy use makes it smarter, not slower.
- CLAUDE.md doesn't manage your work. Loci gives you morning briefings, task tracking, pattern detection, daily journals, and a visual dashboard.
Loci actually uses CLAUDE.md — it's one of the 30+ files in the system. The difference is everything else around it.
One command. Works globally — your AI remembers you in every project, every directory.
curl -fsSL https://raw.githubusercontent.com/codesstar/loci/main/install.sh | bashThe installer clones Loci to ~/loci/, connects it to your AI tools (Claude Code, Codex CLI — auto-detected), and launches onboarding. Takes about 2 minutes.
clawhub install loci-braingit clone https://github.com/codesstar/loci.git ~/loci
cd ~/loci && ./setup.shNote: Without Claude Code or Codex CLI, Loci only works inside the brain directory. Global cross-project memory requires a tool that supports global instruction files.
Windows? Use WSL or Git Bash.
Want to see what a brain looks like? Check out
examples/alex/— a full brain with 3 months of history.New to Loci? Read the Getting Started Guide for a complete walkthrough.
The Method of Loci is one of the oldest memory techniques in human history. Ancient Greek orators would mentally place each point of their speech in a room of an imaginary palace. To recall, they simply walked through the palace — every room held a memory, exactly where they left it.
That's what Loci does for your AI. Every decision, every preference, every lesson you've learned — placed in its own room, ready to be recalled at the right moment.
And the seahorse? In your brain, the hippocampus is the region responsible for forming and retrieving memories. The word "hippocampus" comes from Greek: hippos (horse) + kampos (sea creature) — it literally means seahorse. Neuroscientists named it that because the structure looks like one.
Our logo is a seahorse because Loci is the hippocampus of your AI — the part that turns fleeting conversations into lasting memory.
You don't learn Loci. You just talk to your AI, and four things start happening:
Spend 30 minutes figuring something out with your AI? That knowledge is saved automatically — the decision, the reasoning, and the alternatives you rejected.
You: "We compared Vercel, Railway, and self-hosted. Going with Railway
— Vercel is too expensive at our scale, self-hosted is too much
ops work for a two-person team."
Got it — saved your hosting decision with the tradeoffs.
Next month, when you're wondering "why aren't we on Vercel?" — your AI already knows the full story. You figured it out once. You never have to figure it out again.
Link any project folder with one command. Mistakes you made in Project A become warnings in Project B.
Brain (your memory)
├── Main App "Deployment took 6 hours because we forgot
│ to set up environment variables for the
│ staging environment. Checklist created."
│
├── Side Project "You're about to deploy this. Remember your
│ main app took 6 hours because of missing
│ env vars. Here's the checklist you made."
│
└── Client Work "New deployment here too — applying your
env var checklist from the start."
Every morning, Loci reviews what changed and surfaces insights:
Morning briefing:
- You've started 3 new side projects this month but finished
none of them. Maybe ship one before starting another?
- "Write the project README" has been on your list for 12 days.
Do it today or drop it?
- You estimated the payment integration would take 2 days.
Your last 3 integrations took 2x your estimates.
Long session? Context window full? AI getting slow? Just save and restart.
> save everything before I restart
Done — synced all decisions and progress to your brain.
(open a new terminal)
> picking up where I left off
You were building the notification system. You decided on
email + in-app (no SMS — too expensive for now). The email
templates are done, you were about to wire up the trigger
logic. The file is src/notifications/triggers.ts. Ready?
Not "what project are you working on?" — it knows exactly where you were, what you decided, and what file you had open.
Your skills change. Your focus shifts. Loci tracks the evolution — current state stays lean, history is preserved for when you want to reflect.
January: "data engineer, mass-producing dashboards"
April: "data engineer → building my own analytics product"
July: "founder, shipped v1, first 50 users"
evolution.md records each transition and what triggered it
| Concept | What it does | Why it matters |
|---|---|---|
| Smart saving | Extracts decisions, tasks, and insights from conversation — never saves raw chat transcripts | Your memory stays clean and searchable, not a wall of text |
| Layered loading | Loads only what's relevant to the current conversation. Archives stay out of the way until needed | Fast responses, even after months of accumulated memory |
| Cross-project sync | Your brain is the hub, projects are spokes. Important info flows automatically | Decisions in one project inform work in others |
| Daily review | Morning briefing summarizes yesterday, surfaces patterns, flags stale tasks | You start each day with full context in 10 seconds |
| Growth tracking | When your identity or goals change, old versions are archived automatically | You can look back and see how you've evolved |
| Git-native | Everything is Markdown files in a git repo. git diff shows what your AI learned. git log is your memory timeline |
Full version history, works offline, you own your data |
Deep dive: How It Works — one doc that covers the entire system.
Loci includes an optional visual dashboard — a sci-fi command center for your brain. Zero dependencies, runs with node server.js.
- Today: Task management with drag-drop between Focus/Queue/Complete, calendar timeline
- Plan: Week and month planning with independent goal tracking
- Journal: Rich text editor with image support, AI summaries, daily/weekly/monthly views
- Memory: Your identity, values, and growth — all rendered from your markdown files
- Brain: Full file browser for your memory palace
Everything persists to your markdown files via a local API. The dashboard is a window into your brain, not a separate system.
API docs: docs/api.md — 11 REST endpoints for reading and writing your brain.
Loci is CLI-first — it works anywhere your AI runs. The dashboard is optional.
| Platform | Install | Global Memory |
|---|---|---|
| Claude Code | curl | bash or ./install.sh |
Yes — auto-injects ~/.claude/CLAUDE.md |
| Codex CLI | curl | bash or ./install.sh |
Yes — auto-injects ~/.codex/AGENTS.md |
| OpenClaw | clawhub install loci-brain |
Yes — via skill system |
| Cursor / Windsurf | git clone + ./setup.sh |
No — brain directory only |
OpenClaw users: Loci fixes OpenClaw's memory problem. One install command, and your lobster gets a real brain. Learn more
"I stopped re-explaining my architecture" — Marcus opens his terminal Monday morning. His AI already knows the migration strategy they debated on Friday, the edge cases they found, and why they rejected the simpler approach.
"It saved me from repeating a mistake" — Priya is setting up deployment for a new service. Her AI reminds her that the last time she used that hosting provider, DNS propagation took 48 hours and broke the launch timeline. She switches providers before wasting a day.
"It told me to go to bed" — It's 11:30pm and Dev is still chasing a bug. His AI says "you've been circling the same 3 files for an hour — sleep on it" — then saves exactly where he was so tomorrow's first message picks up mid-thought.
More: User Stories — what Loci actually feels like in daily use.
| Getting Started | Setup walkthrough and first conversation |
| How It Works | Complete system overview |
| User Stories | What daily use feels like |
| Commands & Structure | Directory layout, slash commands, config |
| Other Editors | Cursor, Windsurf, Cline support |
| Privacy | Data protection and what stays where |
| Roadmap | What's coming next |
Contributions welcome — bug fixes, features, docs, or just sharing how you use Loci. Please open an issue first for large changes. See CONTRIBUTING.md.
MIT. See LICENSE.
Loci is built by Callum.
If this gives your AI a better memory, consider giving it a star.