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