Documentation

npx -y @shodh/memory-mcp

# Or install globally
npm install -g @shodh/memory-mcp

pip install shodh-memory

[dependencies]
shodh-memory = "0.1"

docker run -d -p 3030:3030 \
  -e SHODH_HOST=0.0.0.0 \
  -v shodh-data:/data \
  roshera/shodh-memory

# Linux x64
curl -L https://github.com/varun29ankuS/shodh-memory/releases/latest/download/shodh-memory-x86_64-linux -o shodh-memory
chmod +x shodh-memory
./shodh-memory

# macOS ARM64 (Apple Silicon)
curl -L https://github.com/varun29ankuS/shodh-memory/releases/latest/download/shodh-memory-aarch64-darwin -o shodh-memory
chmod +x shodh-memory
./shodh-memory

claude mcp add shodh-memory -- npx -y @shodh/memory-mcp

{
  "mcpServers": {
    "shodh-memory": {
      "command": "npx",
      "args": ["-y", "@shodh/memory-mcp"],
      "env": {
        "SHODH_API_KEY": "your-api-key"
      }
    }
  }
}

{
  "mcpServers": {
    "shodh-memory": {
      "command": "npx",
      "args": ["-y", "@shodh/memory-mcp"],
      "env": {
        "SHODH_API_KEY": "your-api-key"
      }
    }
  }
}

curl http://localhost:3030/health
# {"status":"ok"}

# Production: multiple API keys (comma-separated)
SHODH_API_KEYS=sk-key-1,sk-key-2

# Development: single key (fallback if SHODH_API_KEYS not set)
SHODH_DEV_API_KEY=sk-shodh-dev-change-me

# Client-side: must match one of the server's accepted keys
SHODH_API_KEY=sk-shodh-dev-change-me

# Bind address (default: 127.0.0.1)
# Use 0.0.0.0 only behind authenticated reverse proxy
SHODH_HOST=127.0.0.1

# Port (default: 3030)
SHODH_PORT=3030

# Storage directory
SHODH_MEMORY_PATH=./shodh_memory_data

# Environment mode
SHODH_ENV=production

# Logging level
RUST_LOG=info

SHODH_RATE_LIMIT=4000
SHODH_RATE_BURST=8000
SHODH_MAX_CONCURRENT=200

SHODH_CORS_ORIGINS=https://your-frontend.com
SHODH_CORS_CREDENTIALS=false

curl -X POST http://localhost:3030/api/remember \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "user_id": "user-1",
    "content": "User prefers dark mode",
    "memory_type": "Decision",
    "tags": ["preferences", "ui"]
  }'

curl -X POST http://localhost:3030/api/recall \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "user_id": "user-1",
    "query": "user preferences",
    "limit": 5
  }'

from shodh_memory import Memory

memory = Memory(storage_path="./my_agent_data")

# Store with types for prioritization
memory.remember("User prefers dark mode", memory_type="Decision")
memory.remember("JWT tokens expire after 24h", memory_type="Learning")
memory.remember("Deploy failed: missing env var", memory_type="Error")

# Semantic search
results = memory.recall("user preferences", limit=5)
for r in results:
    print(f"{r['content']} (importance: {r['importance']:.2f})")

# Context summary for LLM bootstrap
summary = memory.context_summary()
print(summary["decisions"])
print(summary["learnings"])

use shodh_memory::memory::{MemorySystem, MemoryConfig, Experience, ExperienceType, Query};

fn main() -> anyhow::Result<()> {
    let config = MemoryConfig {
        storage_path: "./my_agent_data".into(),
        ..Default::default()
    };
    let memory = MemorySystem::new(config)?;

    let experience = Experience {
        content: "User prefers dark mode".to_string(),
        experience_type: ExperienceType::Decision,
        ..Default::default()
    };
    memory.remember(experience, None)?;

    let query = Query::builder()
        .query_text("user preferences")
        .max_results(5)
        .build();
    let results = memory.recall(&query)?;

    for mem in results {
        println!("{}", mem.experience.content);
    }
    Ok(())
}

{
  "hooks": {
    "SessionStart": [{
      "hooks": [{
        "type": "command",
        "command": "bun run $SHODH_HOOKS_DIR/memory-hook.ts SessionStart"
      }]
    }],
    "UserPromptSubmit": [{
      "hooks": [{
        "type": "command",
        "command": "bun run $SHODH_HOOKS_DIR/memory-hook.ts UserPromptSubmit"
      }]
    }],
    "PreToolUse": [{
      "matcher": { "tool_name": ["Edit", "Write", "Bash"] },
      "hooks": [{
        "type": "command",
        "command": "bun run $SHODH_HOOKS_DIR/memory-hook.ts PreToolUse"
      }]
    }],
    "PostToolUse": [{
      "matcher": { "tool_name": ["Edit", "Write", "Bash", "Read"] },
      "hooks": [{
        "type": "command",
        "command": "bun run $SHODH_HOOKS_DIR/memory-hook.ts PostToolUse"
      }]
    }]
  }
}