Install TORTUGA
Start to finish, about ten minutes. One computer holds the memory. Every other computer connects to it. There’s nothing to configure.
TORTUGA Server
Goes on the computer that stays on — a desktop, a spare machine, a home server. It holds the memory and shares it.
TORTUGA Client
Goes on every other computer. It finds the server and wires up Claude by itself.
Set up the Server
Do this once, on your always-on Mac.
Run the installer
- Unzip
TORTUGA-Server-Mac.zip. - Drag TORTUGA Server to your Applications folder (optional, but tidy).
- Right-click it and choose Open — not a double-click, the first time.
- macOS will say it’s from an unidentified developer. Click Open anyway.
A Terminal window opens and shows you what it’s doing. It takes a few seconds.
Enter your password when asked
macOS shows a password box: “TORTUGA needs permission to share your memory folder with your other computers.” Enter your Mac password and click OK.
Restart Claude
Quit Claude completely with ⌘Q and open it again. Closing the window isn’t enough — Claude only reads its settings when it starts.
Ask Claude: “Read my shared-memory graph — how many entities?”
If it answers, the server is live. If you already had a memory graph, it’s all there —
TORTUGA brought it across and kept a backup of the original.
Your dashboard is now at http://localhost:8787 —
graph size, connected computers, and snapshots.
Fill the brain
The step that makes it click. Do it before you add other computers.
Tell Claude to remember everything
Your memory is empty right now. It works — but it doesn’t know anything yet. Fix that in one sentence. Ask Claude:
Remember everything you know about me and my work in the shared memory. Go through our past conversations and write what matters — clients, projects, decisions, how I like things done — into the knowledge graph.
Then let it run. It will read back through what it knows and write it into the graph as entities, relations and observations.
Watch the entity count climb on your dashboard at http://localhost:8787
while it works. That’s your brain filling up.
Everything Claude writes now is what every other computer will know the moment it connects. Seed it first and your second machine arrives already knowing your clients, your projects, and how you work — instead of starting from zero and slowly learning it again.
Connect your other Macs
Repeat for each additional computer. About a minute each.
Run the client installer
- Unzip
TORTUGA-Client-Mac.zip. - Right-click TORTUGA Client → Open, then Open again at the warning.
It finds the server on your network by itself — there’s no address to type. Then it connects the memory and wires up Claude.
Restart Claude
Quit Claude fully (⌘Q) and reopen it.
Ask Claude: “What do you know from my shared memory?”
It should answer with what the other computer knows. That’s the shared brain — in regular
chat, in Cowork, and in Claude Code.
Troubleshooting
The handful of things that actually go wrong, and the fix for each.
The client says it can’t find the server
Three usual causes, in order: the server Mac is asleep or off; the two computers are on different networks (guest Wi-Fi and VPNs both do this); or sharing didn’t get turned on during the server install.
On the server, open http://localhost:8787 — if that page doesn’t load, TORTUGA
isn’t running there. You can also point the client straight at it from Terminal:
tortuga join --host 192.168.1.42
(Use your server’s address, shown on its dashboard.)
macOS says the app is damaged, or nothing happens
That’s the quarantine flag macOS puts on downloaded files. Right-click → Open rather than double-clicking. If it still refuses, open Terminal and run:
xattr -c "/Applications/TORTUGA Server.app"
Claude doesn’t see the memory after installing
Claude only reads its settings at launch. Quit it completely with ⌘Q — closing the window isn’t enough — then open it again.
It stopped working after a reboot or sleep
The connection to the server drops when a Mac sleeps or changes networks. TORTUGA reconnects on its own within a minute. If it doesn’t, run the client installer again — it’s safe to run as many times as you like.
I already had a memory file. Where did it go?
Nowhere. The server install copies it into the new home, keeps a dated backup beside it, and never touches your original. If TORTUGA can’t reach your old memory (say it lived on a drive that isn’t plugged in), it stops and tells you rather than starting you with an empty brain.
How do I remove it?
Run tortuga uninstall on the server, or tortuga leave on a client.
Neither deletes your memory — the graph and every snapshot stay exactly where they are.
I’m on Windows
The Windows build is in final testing. Email sales@thetortugaai.com and we’ll send it the moment it’s ready, at no extra cost.