whale-code

whale-code

Local-first AI agent CLI for inventory, orders, analytics, customers, and more — powered by MCP.

Install

npm install -g whale-code

Or use the one-liner:

curl -fsSL https://whaletools.dev/install.sh | sh

Quick Start

whale login          # Browser-based OAuth to WhaleTools
whale                # Start interactive chat
whale -p "prompt"    # Non-interactive (print) mode

MCP Integration

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "whale": {
      "command": "whale"
    }
  }
}

Claude Desktop / Cursor

{
  "mcpServers": {
    "whale": {
      "command": "npx",
      "args": ["whale-code"]
    }
  }
}

Tools

Tools are loaded dynamically from the database — no code changes needed when tools are added or updated.

Tool	Description
analytics	Sales analytics with flexible date ranges
inventory	Adjust quantities, set stock, transfer between locations
inventory_query	Query inventory summary, velocity, by location
inventory_audit	Start, count, complete inventory audits
orders	Find orders, get details, purchase orders
purchase_orders	Create, approve, receive, cancel purchase orders
transfers	Transfer inventory between locations
products	Find, create, update products and pricing
customers	Find, create, update customers
collections	Manage product collections
suppliers	Find and list suppliers
locations	Find store locations
email	Send emails, manage inbox
alerts	Low stock and pending order alerts
documents	Generate COAs and documents
audit_trail	View audit logs

CLI Commands

whale                          Start interactive chat
whale -p "prompt"              Non-interactive mode
whale login                    Log in to WhaleTools
whale logout                   Clear saved session
whale status                   Show connection status
whale mcp list|add|remove      Manage MCP servers
whale doctor                   Run diagnostics
whale config [key] [value]     View/set configuration
whale update                   Update to latest version
whale help                     Show help

Development

git clone https://github.com/neowhale/whale-code.git
cd whale-code
npm install
npm run dev

License

MIT