S O N

One memory for every AI agent.

An AI coding agent starts each session with no memory of the last one. son keeps the decisions, patterns, facts and todos, so a new session in any agent starts with what the earlier sessions learned. One binary. One SQLite file. No server, no model, no account.

Install son View on GitHub
a new session, in any agent
$ son recall terraform aws
# Recall: terraform aws (current collection: billing-api)

## `gf3b5fke` [pattern] Terraform AWS layout
collection: infra · tags: aws, terraform · updated 2026-11-11

One module per service. Remote state in S3 with a DynamoDB lock.

Your agent forgets. You repeat yourself.

How this project is set up. What was decided last week. What failed, and why. Each new session asks again, and each agent keeps its own notes in its own place.

Across sessions

Tomorrow's session knows today's

The agent saves a decision at the moment it is made. The next session reads it before it starts work.

Across agents

Claude Code writes, Codex reads

All your agents use the same database through the same command. Change agents and the memory stays.

Across projects

"How do we normally set this up?"

Recall searches every project. Matches from the current project come first, and the others follow.


Small on purpose

A command-line tool your agent calls from the shell. Nothing runs in the background.

💾

One Binary, One File

No server, no MCP, no hook. The memory is one SQLite file in your home folder. It works offline, and it makes no network calls.

🤖

Works With Your Agents

Claude Code, Codex, Cursor, Antigravity, Gemini CLI and about 70 more. son init gives each one a skill and a short instruction block.

🔍

Search With No Model

Ranked text search with stemming, synonyms and typo matches. No embeddings, no API key, no token cost. --explain shows why each result matched.

🔗

Typed, Linked Memory

Decisions, patterns, facts, notes and todos. Link them together. A decision that replaces an older one is ranked above it, and the older one is kept.

↩

History and Undo

Every change is kept and can be reversed. A delete is a soft delete. Full backups are made when you ask, and restored exactly.

📍

Knows Where It Came From

Each entry can record how it was learned: the user said it, the agent saw it, or the agent inferred it. son verify records a check, with its date.

🕒

Old Knowledge Gets a Second Look

son review lists facts that were not checked for a long time, todos left open, and possible duplicates. It only lists. Nothing is removed for its age.

🔒

Stored Text Is Not an Order

Agents are told to treat recalled content as reference material. A stored note cannot grant a permission or approve an action.

🏠

Not Only for Code

A collection can be a repository, or any subject: household, travel, personal. Name it once and use it from any folder.


How it works

You set it up once. After that, your agents do the reading and the writing.

Step 1

Set up your agents

$ son init

It creates the database, finds the agents on your machine, and tells each one when to read from son and when to write to it.

Step 2

The agent saves as it works

$ son remember decision \
    "Standard library only" \
    --body "No web framework." \
    --tag python,api

A decision, a way of setting something up, the cause of a failure, a todo. Each is saved when it happens.

Step 3

The next session reads first

$ son context
$ son recall api framework

A new session, in the same agent or a different one, starts with what is stored for this project and finds the rest when it needs it.


Install

macOS, Linux and Windows. It takes about a minute.

1. Download the archive for your system from the releases page.

2. Unpack it and put son on your PATH. On macOS and Linux:

tar -xzf son-v*.tar.gz && sudo mv son /usr/local/bin/

3. Set up your agents:

son init

Or build it from source with Rust:

cargo install --git https://github.com/son-of-w/son

Every command is in the README. Do not store secrets: the database is plain text.


Free on your machine

Everything son does today runs on your machine and is free. Memory that moves between machines through a server is the part we plan to sell.

Available now

son

Free

The binary and every command it has. No account. No network calls. Your data is one file that you own, and you can export all of it at any time.

Install

Planned

son Cloud

Not yet available

The same memory on all of your machines, or shared in a team. Recall will still read from your local file, so it stays fast and works offline.

Tell us you want it

Planned

son Server

Not yet available

The same server, on your company's own machines, for teams that keep their data in-house.

Contact us

Stop repeating yourself to your agent

Free. No account. Your memory stays on your machine.

Install son