Local-first agent memory

Give coding agents a longer memory.

raph indexes code, docs, and notes into a local graph-vector store, then exposes useful context over MCP.

curl -fsSL https://raw.githubusercontent.com/tesh254/raph/main/install.sh | sh

Local first

Graph data stays under ~/.raph/ in an embedded database.

Agent ready

MCP tools search code, crawl docs, traverse relationships, and retain memory.

Single binary

Runs on macOS, Linux, and Windows. Updates itself when stable releases land.

Install

Homebrew

brew install --cask tesh254/raph/raph

Windows PowerShell

irm https://raw.githubusercontent.com/tesh254/raph/main/install.ps1 | iex

Check now with raph update. Set RAPH_NO_AUTO_UPDATE=1 to disable daily automatic update checks.

Start in three commands

raph config init
export OPENROUTER_API_KEY="your-key"
raph init --path .

Run MCP server

raph start

Connect coding agents over stdin/stdout.

Keep code synced

raph sync --path .

Watch indexed repositories in background.

Open graph Studio

raph studio --port 4545

Inspect graph at localhost:4545.

Crawl documentation

raph crawl https://example.com/docs

Add external knowledge to local graph.

Useful commands

raph sync --status
raph sync --remove --path .
raph config check
raph clear
raph version
raph update

Personal-use license

Raph is source-available for private, non-commercial, personal use only. Commercial use, business use, monetization, selling, and reselling require a separate written license.

Read the full license.