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 Claude Code

Get Started

Three steps to connect your data.

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.

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

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

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