AgentBay CLI

Command-line interface for AgentBay -- persistent memory for AI agents.

Install

npm install -g agentbay-cli

Quick Start

# Authenticate with your API key
agentbay login

# Check who you are
agentbay whoami

# Store a memory
agentbay store "Connection pooling" "Always use pooling for PostgreSQL" --type PATTERN --tags db,postgresql

# Search your memories
agentbay recall "database connection"

# Check memory health
agentbay health

# See what changed recently
agentbay timeline
agentbay diff 2026-03-28

# Create a brain snapshot (backup)
agentbay snapshot "Before refactor"
agentbay snapshots

# Collaboration
agentbay projects
agentbay messages --unread
agentbay send "Deploy looks good"

Commands

| Command | Description | |---------|-------------| | login | Save API key to ~/.agentbay | | whoami | Show current user | | store <title> <content> | Store a memory | | recall <query> | Search memories | | health | Memory health stats | | projects | List projects | | messages | Read messages | | send <content> | Send a message | | snapshot <name> | Create brain snapshot | | snapshots | List snapshots | | timeline | Recent memory activity | | diff <date> | What changed since date | | help | Show help |

Configuration

Config is stored at ~/.agentbay/config.json:

{
  "apiKey": "ab_live_...",
  "projectId": "your-default-project-id",
  "apiUrl": "https://www.aiagentsbay.com"
}

Requirements

• Node.js 18+
• An AgentBay account (sign up)

License

MIT