Quickstart

This guide walks you through installing Buddhi AI, pushing your first memory, and connecting an AI agent.

Prerequisites

• Node.js 18 or later
• A Buddhi AI instance (cloud or self-hosted)
• An agent key (obtained from the dashboard)

Step 1: Install the CLI

npm install -g @buddhi-ai/cli

Verify the installation:

buddhi --version

Step 2: Authenticate

Log in with your agent key from the dashboard:

buddhi login --key crtx_YOUR_KEY_HERE --url https://your-buddhi-host

Verify your identity:

buddhi whoami

Expected output:

John Doe <john@company.com> — role IC, level Senior
Endpoint: https://your-buddhi-host

Step 3: Push Your First Memory

Create a file with some knowledge you want to store:

# API Rate Limiting

All external API endpoints must implement rate limiting:
- Public APIs: 100 requests/minute per IP
- Authenticated APIs: 1000 requests/minute per user
- Internal APIs: unlimited

Use Redis sliding window for tracking.

Push it to Buddhi AI:

buddhi push ./api-conventions.md --title "API Rate Limiting Policy" --scope engineering

Step 4: Connect an AI Agent

Claude Code

claude mcp add --transport http buddhi https://your-buddhi-host/mcp \
  --header "Authorization: Bearer crtx_YOUR_KEY_HERE"

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "buddhi": {
      "url": "https://your-buddhi-host/mcp",
      "headers": {
        "Authorization": "Bearer crtx_YOUR_KEY_HERE"
      }
    }
  }
}

Step 5: Recall Memories

Your agent can now search Buddhi AI. Try asking Claude:

"What's our rate limiting policy for external APIs?"

The agent will use the recall tool to find relevant memories with full citations.

What Just Happened?

sequenceDiagram
    participant User
    participant CLI as Buddhi CLI
    participant API as Buddhi API
    participant DB as PostgreSQL + Qdrant

    User->>CLI: buddhi push api-conventions.md
    CLI->>API: POST /api/memories
    API->>API: Resolve scope & clearance
    API->>DB: Insert memory + vector
    API-->>CLI: Memory stored with ID
    CLI-->>User: ✓ Pushed memory
    
    Note over User,DB: Later...
    
    User->>User: Asks Claude about rate limiting
    Claude->>API: recall("rate limiting policy")
    API->>API: Check RBAC permissions
    API->>DB: Vector search (scoped)
    API-->>Claude: Memory with citation
    Claude-->>User: Answer with source

Next Steps