mindbase.one · Persistent memory OS for Claude. Cross-session, cross-machine, cross-agent.
One command installs everything: Cloudflare Worker, database, CLI hooks, and a full web dashboard. Your Claude starts remembering.
npx -p mindbase mindbase-installEvery project. Every agent. Every decision Claude made and why.
Projects: hierarchical view of everything you're working on. Memory count, task count, last session summary. Tap into any project to see the full picture.
Inside each project:
- Backlog: epics and issues with priority and status. Create inline.
- Tasks: pending and completed agent tasks
- Memories: every non-obvious decision Claude saved, tagged by category and importance. Searchable.
- Drive: source files you gave Claude (PDFs, specs, reference docs)
- Artifacts: documents Claude generated (plans, drafts, analyses). Auto-classified by Haiku on upload, no manual sorting.
- Activity: session log for this project
Overview: cross-project command centre: live agent states, recent sessions, stats, cron jobs
Sessions panel: full history of every session across all projects and machines
Claude forgets everything when a session ends. Mindbase doesn't.
Every time you close a session, Claude saves:
- A one-sentence summary of what was done
- Non-obvious decisions in why-format: "chose X, why: Y, not Z because tradeoff"
- Concrete next steps as tasks
- Agent state set to idle
Next session, Claude fetches all of that back before touching a single file.
Multiple Claude sessions running simultaneously, across different machines and projects, sharing the same memory layer. One saves. Another picks it up. No manual handoff.
Claude (mac) ──┐
Claude (linux) ──┤──► Mindbase ──► shared memory, tasks, projects
Claude (server)──┘
This is the hivemind concept: you at the centre, all your agents connected to the same mind.
Mindbase writes mind-sync into your ~/.claude/CLAUDE.md during install. Every Claude session from then on follows a 3-phase lifecycle without being asked:
Open: fetch project context → confirm outcome → flag anything more urgent → set agent working
Mid-session: on context compaction: push progress, pull updates from other agents, direction check
Close: say "close session". Claude saves everything and replies "Saved. Session closed." Nothing else.
npx -p mindbase mindbase-installClaude Code walks you through:
- Cloudflare Worker + R2 bucket deployment
- Neon PostgreSQL setup (needed for semantic vector search)
- Secrets and database migrations
- Auto-discovery and mapping of your existing projects
- mind-cli build and shell profile configuration
- mind-sync written into
~/.claude/CLAUDE.md - Dashboard deployed to Cloudflare Pages
You answer a few questions. Claude does the rest.
Prerequisites: Claude Code CLI · Node.js 18+ · Cloudflare account (free) · Neon account (free)
npx -p mindbase mindbase-joinClaude asks for your MIND_URL and MIND_API_KEY. No infra. No new accounts. Same mind, new machine.
| Layer | What |
|---|---|
| API | Cloudflare Workers |
| File storage | Cloudflare R2 (Drive + Artifacts) |
| AI | Workers AI (embeddings) + Claude Haiku (artifact classification) |
| Database | Neon Postgres with pgvector (semantic memory search) |
| Dashboard | React + Vite on Cloudflare Pages |
| CLI | Node.js: context, fetch, save commands |
Everything except Neon runs on Cloudflare's free tier. Neon is free tier too, it's separate because Cloudflare D1 doesn't support pgvector yet.
| Endpoint | What it does |
|---|---|
GET /context/overview |
Session-start overview (all projects, urgent backlog, recent sessions) |
GET /context/project?name=X |
Full project context on demand |
POST /memory |
Save a memory |
POST /task |
Save a task |
POST /backlog |
Add a backlog item |
POST /session |
Log a session |
POST /agent-state |
Update live agent status |
POST /artifact |
Upload file metadata to Drive or Artifacts |
POST /artifacts/classify |
Reclassify existing artifacts with Haiku |
All requests: Authorization: Bearer <MIND_API_KEY>
Mindbase is designed for Cloudflare but the worker is a standard fetch handler, runs anywhere that supports the WinterCG runtime. R2 can be swapped for any S3-compatible store.
See mind-worker/wrangler.toml.example for configuration reference.
PolyForm Noncommercial 1.0.0 — free for personal and non-commercial use. For commercial licensing, reach out on LinkedIn.