Quick Start

Start the stack

git clone https://github.com/Saturate/HUSK.git
cd HUSK
docker compose up -d

This starts three services:

• HUSK — the memory server (port 3000)
• Qdrant — vector database for semantic search
• Ollama — local embedding model

The embedding model (nomic-embed-text) is pulled automatically on first run.

Create your admin account

Open http://localhost:3000/setup and create your admin user.

Create an API key

1. Log in at http://localhost:3000
2. Go to API Keys → Create Key
3. Copy the key (husk_...) — you won't see it again

Connect Claude Code

Add a .mcp.json to your project root (or ~/.claude/.mcp.json for global access):

{
  "mcpServers": {
    "husk": {
      "type": "http",
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer husk_your-api-key-here"
      }
    }
  }
}

Restart Claude Code. The MCP tools (search, remember, list_projects, session_context, etc.) are available immediately.

See Connecting for more options including the Claude Code plugin.