quickstart

give your project a memory

Three commands. After this, every session your AI starts already knowing your decisions, conventions, and history — no re-explaining.

install

Compiled binary from PyPI. Python ≥ 3.11.

bash

pip install nodestone

nodestone init

Creates a local memory store for the current project and activates your license. Your browser opens the activation page; the terminal picks up the signed license automatically — no key to paste.

bash

cd your-project
nodestone init
# → browser opens for activation (Free / Pro / Team)
# → memory store created at ~/.nodestone/<project>.db
# ✓ nodestone ready

Write and recall memories directly:

bash

# remember a decision
nodestone memory save "auth: Redis sessions over JWT — need server-side revocation"

# recall it later, semantically
nodestone memory recall "why redis for auth?"
# → "auth: Redis sessions over JWT — need server-side revocation"

nodestone mcp

Starts the MCP server over stdio. Any MCP-compatible host can now read and write your project memory — automatically, at the start of every session.

bash

nodestone mcp
# MCP server ready — stdio transport
# project memory exposed: recall / remember / summarize
# waiting for tool calls...

claude mcp add

Wire nodestone into Claude Code (or any MCP host) once. From then on, Claude reads your project memory before it does anything.

bash

# Claude Code CLI
claude mcp add nodestone nodestone mcp

# verify
claude mcp list
# → nodestone   nodestone mcp   ✓ running

Or add it manually to your MCP config:

json

{
  "mcpServers": {
    "nodestone": {
      "command": "nodestone",
      "args": ["mcp"]
    }
  }
}

Team tier serves the same memory over HTTP so every developer shares one context:

bash

# on the shared host
nodestone mcp --http --port 8770

# on any teammate's machine
claude mcp add nodestone-remote --transport http http://YOUR-IP:8770

pairs with atlas + deepstrain

atlas maps your code and deepstrain changes it — point both at the same project and nodestone keeps the context they generate. Understand, execute, remember: one loop.

also from us

deepstrain — autonomous execution · atlas — code intelligence

see pricing bundle →