BORG Get started
  • Free and
  • Runs on your Mac
  • Codex · Claude · Grok

Your AI forgets.
BORG remembers.

BORG gives your AI coding agents one shared memory that lives on your Mac. Codex saves what it learns about your project there and gets it back the next time it starts work. Claude Code and Grok can join after a few setup steps. Stop explaining your project from scratch.

Get started See how it works

Needs a Mac with an M-series chip (M1 or newer) and 20 GB of free space. Will it run on my Mac?

Drawn as ships in space: a large green cube labelled BORG, shared memory, on your Mac. Lines link it to smaller cubes labelled Codex, Claude and Grok, each an AI agent, and Tools for files, apps and the browser.

The difference

Monday you explain.
Tuesday it already knows.

Example · without BORG

Monday

Our app uses Supabase for logins and Tailwind for styling. Please never use inline styles.
Got it. I'll keep that in mind.

Tuesday · new chat

Add a settings page.
Sure. Which login system and styling library does your app use?

You explain it all again.

Example · with BORG

Tuesday · new chat

Add a settings page.

BORG added 3 notes from Monday

On it. I'll use your Supabase login and Tailwind styles, with no inline styles, like you asked.

It picks up where you left off.

Example conversation. Real replies depend on your project and your AI tool.

How it works

Three steps, all on your Mac.

  1. Your agent works as usual.

    As Codex works on your project, BORG saves useful facts from each session, for example which tools you use and what you decided.

  2. BORG files it away.

    Notes go into a private memory in one folder on your Mac. Small AI models, also on your Mac, sort the notes and link related facts.

  3. Next time, it remembers.

    When Codex starts a task, BORG hands it the notes that matter for that task.

is connected for you during setup. and Grok connect with a few extra steps, then search the same memory.

What you get

One install. Three parts.

The BORG cube opened up into three stacked layers, joined by glowing green beams. Numbers 1, 2 and 3 mark the top, middle and bottom layers.

  1. Memory

    Saves what your agents learn and finds the right note again, even when you word it differently.

  2. Tools

    Lets your agents work on your Mac: open files, run commands, run long jobs and use their own browser. macOS asks you before an agent can control other apps.

  3. Teamwork

    Your agents can message each other and keep one shared task list, so everyone can see what's done and what's next.

Also included, and switched off: three small trained models for research.

Will it run on my Mac?

Answer three questions.

Your chip and memory are in the Apple menu under About This Mac. Free space is in System Settings → General → Storage.

1. What kind of computer?

M-series chips are Apple's own: M1, M2, M3, M4 and newer. Macs have used them since late 2020. About This Mac shows yours next to "Chip".

2. How much memory?
3. How much free space?

Good to try

Good for trying BORG with light use.

This matches our starter plan. Start small and watch how your Mac feels before you rely on it. You have enough space to install; plan for about 50 GB free as your memory grows.

Your plan
Starter · 16 GB
Free space to plan for
About 50 GB
Get started

Based on our planning guide. Real speed depends on what else your Mac is doing.

Get started

Let your AI set it up.

The easiest way: give your AI agent the instructions and let it do the typing. The message below asks it to check your Mac first and explain each step before it runs it.

Let your AI do it

  1. Open Codex or Claude Code in .

    Use the AI coding agent you already have.

  2. Paste this message.
    Message for your AI agent

    Read https://borg.utlyze.com/llms.txt and the installation runbook it links to. Help me install BORG on this Mac. Check my Mac first, explain each step in plain words before you run it, use my own accounts, and tell me what works and what still needs setup.

  3. Answer its questions.

    It installs BORG, helps you sign in to Codex and tells you what works.

Type it yourself

In the third line, replace yourname with a short lowercase name for you, like jamie.

A short lowercase name for you, like jamie. BORG uses it as your owner ID. We fill it into the commands below.

Terminal · paste all six lines
  1. git clone https://github.com/h3ro-dev/borg.gitDownloads BORG.
  2. cd borgMoves into its folder.
  3. ./install.sh --owner yournameInstalls BORG into ~/.borg, with its local AI models.
  4. "$HOME/.borg/bin/borg" onboardShows your next steps.
  5. "$HOME/.borg/bin/borg" auth codexSigns you in to Codex with your own account.
  6. "$HOME/.borg/bin/borg" doctorChecks what's working.

Want every option, including ChatGPT on the web and other machines? Read the install guide.

You're set up when…

"$HOME/.borg/bin/borg" doctor says you're ready. If something still needs setup, it tells you what.

Then try it

Tell Codex one fact about your project. Start a new chat and ask about it.

Good to know

Questions people ask first.

Is BORG free?

Yes. BORG is open source under the MIT license. You use your own AI accounts, such as the one you use for Codex, and their normal costs apply.

Where is my data stored?

On your Mac, in one private folder (~/.borg). BORG never connects to our setup or to anyone else's.

When your AI uses a memory, that note becomes part of your chat with that AI's company, like anything you type.

Will it slow down or change my Mac?

BORG runs several background services that only your Mac can reach. Its local AI models use memory, so a Mac with more memory runs it more comfortably.

macOS asks your permission before an agent can control other apps or see your screen.

Which AI tools work with it?

Codex is connected during setup. Claude Code and Grok work after a few extra steps in the install guide. ChatGPT on the web can connect too, through your own Cloudflare account. That one is for advanced users.

Do I need to know how to code?

You need to be comfortable pasting commands into Terminal, or letting your AI agent do it for you.

How do I remove it?

Stop BORG, then remove its folder and its background services. The install guide explains how, including backing up first.

Go further

Curious how far it goes?

How we run ours

Our own setup across seven Macs, with a memory judge, nightly cleanup and quality checks. Some of it isn't in the download yet.

See our setup →

Lab notes

Our Stardate log of every experiment: what worked, what didn't and what we still don't know.

Read the lab notes →

Plan several machines

For bigger setups: size each machine, pick its parts and download a plan.

Open the planner →

Read the code

Everything is public. Look through it before you install.

Open GitHub →