An associative memory you can run anywhere.

# state & recall; '-' reads stdin; a miss exits 3, so recall composes in a shell
echo "the launch is Friday" | neuron observe user -
neuron get user "when is the launch"          # -> Friday
neuron get user "gate code" || research ...    # routes on the knowledge gap

# interactive shell: recall, spreading assoc, multi-hop chain, vars
neuron shell case
  case> chain Lena Marsh -> partner -> creditor
  Eliza Crowe  (via Lena Marsh -> Marcus Vane -> Eliza Crowe)

# pipe ANY app's output into a scope (transparent tee + substring filters)
my-service 2>&1 | neuron capture logs --tee --only ERROR
neuron run build -- cargo test       # spawn, tee, record, keep its exit code

# mount neuron-db as Claude Code's memory (never clobbers a config)
neuron mount claude

use neuron_core::db::NeuronDB;

let db = NeuronDB::open("app.db", 500);        // file path, max facts/scope

db.observe("user:42", "the plan is pro");          // INSERT
db.get("user:42", "what plan?");                  // Some("pro")

db.observe("user:42", "the plan is enterprise");   // "UPDATE": newest wins
db.get("user:42", "what plan?");                  // Some("enterprise")

db.forget("user:42", Some("plan"));             // DELETE by substring
let t = db.turn("user:42", "what is my color?");  // t.reply == "teal."

# turn: store a fact (one endpoint per scope)
curl -d '{"message":"the api key is zeta-9931"}' \
     localhost:8088/v1/user:42

# get a single value back
curl -d '{"query":"what is the api key?"}' \
     localhost:8088/v1/user:42/get          # -> {"value":"zeta-9931"}

# top-k memory block for an LLM context window
curl -d '{"query":"api key","k":5}' \
     localhost:8088/v1/user:42/recall_many

docker build -t neuron-db .
docker run -d -p 8088:8088 -v neuron-data:/data \
  -e NEURON_DB_KEY=$(openssl rand -hex 16) neuron-db

# or with compose: persists + restarts on failure
NEURON_DB_KEY=$(openssl rand -hex 16) docker compose up -d

// Rust, feature "secure"
let v = SecureNeuronDB::open("vault.db");
v.put("alice", "alice-secret", "wifi password", "hunter2");
v.get("alice", "alice-secret", "what is the wifi password?"); // Some("hunter2")
v.get("alice", "WRONG",        "what is the wifi password?"); // None

# CLI
neuron --db vault.db --secret s3cr3t secure-put alice "wifi password" hunter2
neuron --db vault.db --secret s3cr3t secure-get alice "what is the wifi password?"

# build the native stdio MCP server (no Node, no Python)
cargo build --release --features mcp --bin neuron-mcp

# point a client at it — e.g. a Claude Desktop mcpServers entry
{
  "neuron-db": {
    "command": "/path/to/neuron-mcp",
    "env": { "NEURON_MCP_DB": "/data/memory.db" }
  }
}

# install
npm i @gary23w/neuron-db

// then — browser, Node, Deno, or a Worker
import { NeuronDB } from "@gary23w/neuron-db";
const db = await NeuronDB.forBrowser(new URL("@gary23w/neuron-db/wasm", import.meta.url));

db.observeMany("user:42", ["the api key is zeta-9931"]);
db.recall("user:42", "what is the api key?");   // -> ["the api key is zeta-9931"]
db.route("user:42", userMessage);              // {type:"answer"|"escalate"|"fetch"|"store", value, facts}