Free · Open Source · MIT

Context that
survives the session.

NockBrain is the open-source memory layer for AI agents. Diary entries, handoff records, and identity documents, written as your agents work, restored the moment they boot. No more re-explaining the project.

Install NockBrain View on GitHub ↗

$ brew install nocktechnologies/tap/nockbrain

What it remembers

Three kinds
of memory.

NockBrain writes to a local SQLite store. Every record is plain, queryable, and yours: no cloud, no lock-in.

Diary 01 · log

A running log of what each agent did and decided. Timestamped, searchable, and compiled into a brief on the next boot.

# diary entry
when  = "14:02"
agent = "kit"
note  = "shipped PR 2 · CI green"

Handoffs 02 · pass

Structured task transfers between agents. The receiving agent boots with the full brief, no context lost in the gap.

# handoff record
from = "iris"
to   = "kit"
task = "review PR 2"

Identity 03 · self

A durable document per agent: role, voice, standing orders. Loaded first, every session, so the agent is itself from line one.

# identity doc
agent = "kit"
role  = "reviewer"
orders = ["verify before merge"]

How it works

Persist context.
In four steps.

NockBrain is a single binary and a local database. It hooks your agent's lifecycle and handles the rest.

Initialize the store

nockbrain init creates a local SQLite database in your project. No accounts, no server.

Agents write as they work

Diary entries, handoffs, and decisions are appended through a tiny CLI or MCP tool. One line each; agents barely notice.

Context is compiled on boot

The next session starts with nockbrain brief: a compact, ranked digest of everything relevant, dropped straight into context.

Memory consolidates over time

Old entries are summarized and archived automatically, so the brief stays sharp instead of bloating across hundreds of sessions.

Install

One line. No accounts. No telemetry.

# homebrew (macOS, Linux)
$ brew install nocktechnologies/tap/nockbrain

# initialize in your project
$ nockbrain init

# compile context for the next session
$ nockbrain brief
[ok] 2,400 entries · 97% retention restored