Rockerbox CLI

rbox CLI

Command-line access to your Rockerbox data

Query your multi-touch attribution data, analyze ROAS by channel, and explore conversions—all through natural language with Claude.

macOS Linux Windows Claude Code

Requires Claude Code (terminal or desktop app). Does not work with claude.ai chat.

Recommended

Let Claude set it up for you

Open Claude Code and paste the prompt below. Claude will read the setup guide, install the CLI, authenticate your account, and configure everything automatically.

Set up the Rockerbox CLI on my machine.
Follow the instructions at https://cli.rockerbox.com
to install the binary, authenticate, and initialize skills.

While Claude handles the install, scroll down to see what you can do with your data.

Manual Setup

Four steps to install and configure everything yourself.

Show steps
1

Install

Run the installer to download and set up the latest version:

$ curl -fsSL https://cli.rockerbox.com/install.sh | bash
Requires bash. Run bash --version to verify.
Windows: Download the .zip from the latest release, extract it, and run .\install.ps1 in PowerShell.

The installer detects your OS and architecture, downloads the correct binary, verifies its SHA-256 checksum, and sets up shell completions.

2

Authenticate

Log in with your Rockerbox account. This opens a browser for secure authentication:

$ rbox login

Verify your identity and current advertiser:

$ rbox whoami
3

Connect to Claude Code

How it works

rbox includes skills for Claude Code that give Claude context about your Rockerbox data and pre-approved permissions to run commands on your behalf.

Create a folder for your Rockerbox work and initialize it. You can put this anywhere—the location doesn't affect how rbox works:

$ mkdir ~/rockerbox && cd ~/rockerbox
$ git init
$ rbox agent init
Already have a project folder? You can run rbox agent init from any git repository.
Works with Claude Code in the terminal or the desktop app. The experience is the same.

This command:

  • Installs rbox skill files into .claude/skills/rbox-cli/
  • Grants Bash(rbox:*) permission so Claude can run rbox commands
  • Prints a quick-start guide for your first session
Important: Always launch Claude Code from this folder. The skills are installed here—if you open Claude from a different directory, it won’t find them and queries will be slower or fail.
4

Verify

Confirm everything installed correctly before you start querying:

$ rbox agent skill list

You should see rbox-cli in the output. If not, re-run rbox agent init from your Rockerbox folder.

To add optional skills for specific workflows:

$ rbox agent skill add aggregate-mta
Run rbox agent skill list --available to see all skills you can add.

Explore Your Data

The fastest way to get started is to ask Claude. Once you've run rbox agent init, open Claude Code and try:

Curious what's in your data? Just ask.

Claude already knows your Rockerbox account and what queries are available. Ask it anything—from "what can I do?" to specific analysis questions. No need to memorize commands; Claude handles that for you.

Try one of these to get started
>
"What conversion events are available in my account?"
Discover your data before querying
Claude Code
>
"Show me last week's attribution data by channel"
Pull MTA results broken down by tier
Claude Code
>
"What's my ROAS by tier_1 for the last 30 days?"
Analyze return on ad spend across platforms
Claude Code
🦆

Your Data, Your Machine

rbox includes a built-in DuckDB database. When Claude queries your data, it caches results locally so follow-up questions run instantly—no re-fetching, fewer tokens, faster answers.

📡
Query API
Claude fetches your
attribution data
💾
Cache Locally
Results stored in
DuckDB on your machine
Instant Queries
Follow-ups run from
local cache
First query — API
2.3s avg
Network round-trip + server processing
Follow-up — DuckDB
0.04s avg
Local SQL — no network, no tokens spent
~60×
Faster follow-ups
0
Extra tokens used
100%
Local & private
Or explore the CLI directly
CommandWhat it does
rbox services List available API services
rbox datasets datasets list List available datasets
rbox datasets datasets aggregate-mta query post --spec View query schema and required fields
$ rbox datasets datasets list

Troubleshooting

Claude is your first line of support. If something isn’t working, ask it directly in the terminal. Here are the most common issues:

Skills not loading / slow queries

If Claude doesn’t seem to know about rbox commands, your skills may not be installed in the current directory.

$ rbox agent skill list

If this returns nothing, cd into the folder where you ran rbox agent init and try again. If you’re not sure which folder that was, re-run setup:

$ cd ~/rockerbox && rbox agent init

Authentication expired

If you see permission errors or “unauthorized” messages, your token may have expired.

$ rbox login
$ rbox whoami

Claude Code vs. Claude Chat

The rbox CLI requires Claude Code, the version that runs locally on your machine and can execute terminal commands. It does not work with the browser-based Claude chat at claude.ai.

You can use Claude Code via the terminal CLI or the desktop app (look for “Claude Code” in the app).

Still stuck? Ask Claude: "I'm having trouble with rbox setup, can you help me troubleshoot?"