@nano-step/nano-brain 2026.6.401 → 2026.6.402
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +22 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -10,6 +10,28 @@
|
|
|
10
10
|
|
|
11
11
|
nano-brain is a persistent memory server for AI coding agents that solves session amnesia. It automatically ingests AI sessions, notes, and codebase files, indexes everything with hybrid search (BM25 + pgvector), and serves memories via MCP tools and REST API. Built in Go with PostgreSQL — single static binary, zero CGO dependencies.
|
|
12
12
|
|
|
13
|
+
## Use Cases
|
|
14
|
+
|
|
15
|
+
### Multi-machine developer (primary use case)
|
|
16
|
+
You work on your office PC, home machine, and personal laptop — each with a different Claude Code or OpenCode session. Without shared memory, your AI agent forgets everything between machines.
|
|
17
|
+
|
|
18
|
+
Deploy nano-brain on a VPS (or any always-on server) with a PostgreSQL instance. Every session you run on any machine gets harvested and indexed there. When you switch machines, your agent picks up exactly where you left off — decisions, context, code knowledge, all there.
|
|
19
|
+
|
|
20
|
+
```
|
|
21
|
+
Office PC ──┐
|
|
22
|
+
├──► nano-brain on VPS ──► shared PostgreSQL
|
|
23
|
+
Home Mac ───┘
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
### Persistent AI agent memory
|
|
27
|
+
AI agents forget everything when the session ends. nano-brain gives them durable, searchable memory across sessions — decisions made, patterns discovered, code written — so they don't repeat work or ask the same questions twice.
|
|
28
|
+
|
|
29
|
+
### Code intelligence for large codebases
|
|
30
|
+
nano-brain builds a symbol graph of your codebase: functions, types, dependencies, call chains. Agents can ask "what breaks if I change this function?" (`memory_impact`) or "trace the call chain from this entry point" (`memory_trace`) — across files, across sessions.
|
|
31
|
+
|
|
32
|
+
### Notes and documentation search
|
|
33
|
+
Write structured notes, ADRs, or decision records into nano-brain. Hybrid search (BM25 + semantic) retrieves them by keyword or concept. Agents can surface the right context without you having to remember where you put it.
|
|
34
|
+
|
|
13
35
|
## Key Features
|
|
14
36
|
|
|
15
37
|
- **Hybrid search** — BM25 full-text + pgvector HNSW cosine similarity + RRF fusion + recency decay
|