CLI Overview

The Buddhi CLI lets you authenticate agent keys and push memories directly from your shell. It's designed for CI/CD workflows, scripting, and quick memory operations.

Features

• Authentication — Login with agent keys
• Memory Push — Upload files as memories
• Identity Check — Verify stored credentials
• Zero Dependencies — Pure Node.js, no external packages

Quick Start

# Install
npm install -g @buddhi-ai/cli

# Login
buddhi login --key crtx_YOUR_KEY_HERE

# Push a memory
buddhi push ./design-decisions.md --title "Auth Architecture" --scope engineering

# Verify identity
buddhi whoami

Commands

Configuration

Credentials are stored in ~/.buddhi/config.json with mode 600 (owner read/write only).

{
  "apiKey": "crtx_...",
  "url": "https://your-buddhi-host",
  "actingUser": {
    "name": "John Doe",
    "email": "john@company.com",
    "role": "IC",
    "level": "Senior"
  }
}

Environment Variables

Next Steps