# Persistia: Give Claude Code the persistent memory it was missing (open source)

> Source: <https://github.com/bernardohcrocha/persistia-for-claude-code>
> Published: 2026-06-03 17:44:13+00:00

**Persistia**

Give Claude Code the persistent memory it was missing and turn it into your operational co-pilot.

Claude Code has no operational memory. Every session starts from zero. You re-explain your stack, paste context, repeat yourself.

**Persistia fixes that.** On first run, it scans your entire project — code, architecture, docs, and configs. Reads your `.env`

files and uses credentials you already have. Stores everything in small, focused files with a navigation index. Then monitors changes via `git diff`

: 1,000 files, 3 changed, it reads 3. Token-efficient by design.

**The result:** an agent that always knows your full project and stays up-to-date automatically — even as you ship new features, add docs, or change your stack.

**Minimum input. Maximum output.**

Open Claude Code in your **project root folder**, then run:

```
curl -fsSL https://raw.githubusercontent.com/bernardohcrocha/persistia-for-claude-code/main/setup.sh | bash
```

Claude scans your project and asks only what it can't find. No forms. No config files. Just a conversation.

Requires:git · Node.js 18+

Optional:[GitHub CLI](`gh`

) — automatically creates a private brain repository with cloud backup on every update. Format your machine,`git clone`

the brain repo, continue exactly where you left off.

Scheduler included:installs automatically (launchd on macOS, systemd on Linux).

**Initial indexing**— on first run, scans your entire project: code, docs, configs, and environment files. Asks only what it can't find on its own. Uses credentials you already have — no manual reconnection.**Self-updating memory**— runs`git diff`

daily. Only what changed gets read. No unnecessary context loaded.**Permanent skills**— say it once → written to`_brain/skills/`

, loaded at every future session**Autonomous tasks**— schedule any task in plain language, runs automatically with full context. Each task in`_brain/tasks/queue.json`

supports`batch_size`

(cap items per run — prevents timeouts on large lists) and`timeout_minutes`

(default: 5). Easy to customize.**Proactive scan**— every 3 days when idle, it scans metrics, customers, and channels and flags what it notices. Always suggests, never acts unilaterally.**Live dashboard**— open`_brain/dashboard.html`

, auto-refreshes every 5 min**Shareable memory**— its own private git repo. Format your machine,`git clone`

the brain repo, continue exactly where you left off. Shareable with your team.

Unlike Hermes Agent, Agent Zero, or OpenClaw — context updates itself. No manual maintenance required.

Everything in `_brain/`

is plain text — readable, editable, and version-controlled.

A dashboard shows numbers. This answers questions and executes orders — cross-tools.

**Ask**— revenue, churn, at-risk accounts, support patterns — across all your tools at once.** Give orders**— outreach, reports, follow-ups. Executed using credentials you already have.** Schedule**— any task, in plain language, runs automatically with full context.

→ *"Which customers dropped usage 30%+ this month? Cross-check their support history and draft a personalized re-engagement message for each."*

→ *"Every Monday: pull last week's numbers from Stripe, flag anomalies, and queue a follow-up for any account that dropped below quota."*

→ *"Find signups from the last 30 days with no activity. Visit each company's website and write a personalized email leading with the most relevant pain points."*

```
_brain/
├── .git/             ← isolated brain repository, pushes to private GitHub remote
├── index.md          ← agent reads this first, every session
├── dashboard.html    ← live command center, auto-refreshes in browser
├── core/             ← product, brand, ICP
├── operations/       ← metrics + customers, auto-updated daily
├── skills/           ← permanent rules, created and updated automatically
└── tasks/            ← scheduled tasks queue, managed automatically
```

→ [How the git architecture works](/bernardohcrocha/persistia-for-claude-code/blob/main/ARCHITECTURE.md)

No subscriptions. 100% free. 100% open source.

*Claude Code is a product of Anthropic. Persistia is an independent open-source project, not affiliated with or endorsed by Anthropic.*

MIT License · 2026