OPEN SOURCE · MCP NATIVE · YOUR FILES

Your next session.
A little less
starting over.

Keep the findings, decisions, and hard-won context your AI would otherwise forget. HyperKB turns them into connected, searchable memory you own.

Plain MarkdownLocal searchAny MCP client
A FINDING, REMEMBEREDIllustrative workflow
CLIENT A · TODAYOne useful discovery
MCP
infra.postgres.mdSAVED
>>> 1789142400
@type: decision
@tags: connection-pool

Use a pool limit of 20.
Higher limits exhaust our worker budget.

[[app.performance]]
<<<
READY FOR THE NEXT SESSION

The reason stays with the decision.

01 / 03

Record what you learned, together with why it matters.

Good context shouldn't depend on one conversation.

01 Readable by you02 Useful to your agent03 Portable by design

FROM A MOMENT TO A MEMORY

Keep the insight.
Bring back the context.

HyperKB gives an agent a place to put what matters—and a way to find it again when the work calls for it.

01 / CAPTURE

Write the useful part.

A finding, a decision and its rationale, or a task for later. Add a topic, a status, and links to related knowledge.

hkb_add(
 to="infra.postgres",
 content="@type: decision\n…"
)
02 / CONNECT

Give it a place.

Dotted filenames organize topics. Wiki-links connect related ideas. The Markdown is yours to read, back up, and move.

infra.postgres
app.performanceops.runbooks
03 / RETRIEVE

Find the right context.

Search with ripgrep and BM25 ranking, build a session briefing, or pack relevant entries into an estimated context budget.

QUERY“Why is our pool limited to 20?”
infra.postgresdecision

The decision and its original rationale, together.

USEFUL MEMORY. ORDINARY FILES.

Your tools change.
Your knowledge stays.

Keep a knowledge base outside your conversations. Connect your MCP clients to it, carry it between machines, and read it without an AI tool at all.

Understand the storage model

Markdown is the source.

Your knowledge lives in named text files. SQLite is an index you can rebuild.

Each client has its own session.

Local MCP clients share the knowledge base while keeping their focus and provenance separate.

Sync is a choice.

Keep recording locally through outages and upgrades. Optional S3 sync checks compatibility before sharing your pending changes.

MAKE THE NEXT SESSION BETTER

Start with one
useful memory.

Install HyperKB, connect your MCP client, and save a decision worth remembering. No model API key is needed for local search.

Python 3.10+ripgrepMCP client
Complete setup guide
INSTALL / TERMINAL
git clone https://github.com/calvincs/hyperkb
cd hyperkb
python3 -m venv .venv
.venv/bin/pip install -e ".[mcp]"
.venv/bin/hkb init
Install ripgrep with your system package manager, then register the absolute path to hkb-mcp in your client.
Next: connect your MCP client

A SHORTER PATH TO UNDERSTANDING

Read it your way.

All documentation