Brainctl

brainctl

**Forgetful agents, fixed by a SQLite file.**

One `brain.db` gives your agent durable memory across sessions — facts learned, decisions made, entities tracked, and state handed off. No server. No API keys. No LLM calls required.

**Saturday May 17, 2026 — the agent memory marketplace opens at [brainctl.org/marketplace](https://brainctl.org/marketplace).** Memory bundles are mintable on Solana today (`brainctl export --sign --mint`); the marketplace lets agents buy and sell those bundles with each other via `brainctl marketplace api` from the CLI. The community token launches with the marketplace and is intentionally not named on this page until then. See the [Mint section](#feature-checklist) and [Marketplace section](#feature-checklist) below for the primitives, and the [website](https://brainctl.org) for the full launch story.

from agentmemory import Brain

brain = Brain(agent_id="my-agent")
ctx = brain.orient(project="api-v2")           # session start: handoff + events + triggers + memories
brain.remember("rate-limit: 100/15s", category="integration")
brain.decide("use Retry-After for backoff", "server controls timing", project="api-v2")
brain.wrap_up("auth module complete", project="api-v2")  # session end: logs + handoff for next run

Install

pip install brainctl

Requires Python 3.11+. SQLite is built-in. No other mandatory dependencies.

pip install brainctl[mcp]     # MCP server — 100 visible tools for Claude Desktop, Cursor, VS Code
pip install brainctl[vec]     # vector similarity search (sqlite-vec + Ollama)
pip install brainctl[signing] # Ed25519-signed memory exports + optional Solana on-chain pinning
pip install brainctl[all]     # everything

5-line example

from agentmemory import Brain

brain = Brain(agent_id="research-bot")
brain.remember("OpenAI rate-limits at 500k TPM on tier 3", category="integration")
results = brain.search("rate limit")          # FTS5 full-text, stemming,