by christopherkarani · christopherkarani/Wax
Apple-Silicon-native vector memory — Metal-accelerated, sub-ms retrieval, packaged as a Swift binary you run locally.
Wax is a memory layer specifically tuned for Apple Silicon: Metal kernels for HNSW, in-process Swift API, MCP front-end. Useful for local agents on Mac that want fast RAG without a separate vector DB.
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"wax-mcp": {
"command": "wax",
"args": [
"mcp"
]
}
}
}Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.
{
"mcpServers": {
"wax-mcp": {
"command": "wax",
"args": [
"mcp"
]
}
}
}Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.
{
"mcpServers": {
"wax-mcp": {
"command": "wax",
"args": [
"mcp"
]
}
}
}Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".
{
"mcpServers": {
"wax-mcp": {
"command": "wax",
"args": [
"mcp"
]
}
}
}Same shape as Claude Desktop. Restart Windsurf to pick up changes.
{
"mcpServers": [
{
"name": "wax-mcp",
"command": "wax",
"args": [
"mcp"
]
}
]
}Continue uses an array of server objects rather than a map.
{
"context_servers": {
"wax-mcp": {
"command": {
"path": "wax",
"args": [
"mcp"
]
}
}
}
}Add to context_servers. Zed hot-reloads on save.
claude mcp add wax-mcp -- wax mcpOne-liner. Verify with claude mcp list. Remove with claude mcp remove.
When to use: You want fast, private retrieval over Markdown notes.
Outcome: Private, fast RAG without a cloud vector DB.
Index your project tree
| Tool | Inputs | When to call | Cost |
|---|---|---|---|
| index | (see docs) | Index a directory | 1 call |
| query | (see docs) | k-NN over index | 1 call |
No Metal deviceWax requires Apple Silicon; falls back to CPU on Intel but slower
| Alternative | When to use it instead | Tradeoff |
|---|---|---|
| memsearch | Cross-platform | No Metal acceleration |