Skip to content
Databox CLI logo

Databox CLI

Automate Databox workflows and manage metrics and dashboards from the terminal

From $4/mo per user (free plan available)
Tracked since 2026

The Bottom Line

Price
From $4/mo per user (free plan available). Compare plans

Key facts

  • Command-line tool for the Databox API, covering data sources, metrics, dashboards, and more
  • Usable in scripts or through AI agents for automated data management
  • Open source, npm-installable, and targets the Databox V2 API

Pros

  • Free and open source
  • Automates Databox workflows without a GUI
  • Comprehensive coverage of Databox API features

Cons

  • Requires Node.js 18 or later
  • Limited to the Databox platform, not a general-purpose CLI

What is Databox CLI?

Databox CLI is a command-line interface for the Databox API, enabling users to manage data sources, datasets, custom metrics, dashboards, users, organization accounts, connections, and billing directly from the terminal. It is designed for developers and data analysts who want to automate Databox workflows, integrate with scripts, or leverage AI agents for data operations. The CLI targets the Databox V2 API, providing a comprehensive set of commands for listing, creating, and reading data, as well as retrieving metric values with granularity and dimension support. It also includes a migration guide for users upgrading from older versions, ensuring a smooth transition. The tool is open source and can be installed globally via npm, requiring Node.js 18 or later.

Key Features

  • Manage data sources and datasets
  • Create and read custom metrics
  • Retrieve metric values with date ranges, granularity, and dimensions
  • List and search dashboards, users, accounts, and connections
  • Handle billing operations from the terminal
  • Support for scripted and AI-agent usage
  • Sync status reporting for metric data

Pricing Plans

Free Trial
Databox CLI plans and prices
Plan Price Details
Free

$0

  • Unlimited public and private repositories
  • Dependabot security and version updates
  • 2,000 CI/CD minutes/month
+3 more
  • 500MB of Packages storage
  • Issues & Projects
  • Community support
Team

$4 / user/month

  • Everything from Free, plus access to GitHub Codespaces
  • Repository rules
  • Multiple reviewers in pull requests
+8 more
  • Draft pull requests
  • Code owners
  • Required reviewers
  • Pages and Wikis
  • Environment deployment branches and secrets
  • 3,000 CI/CD minutes/month
  • 2GB of Packages storage
  • Web-based support
Enterprise

$21 / user/month

  • Everything from Team, plus GitHub Copilot access
  • Agent governance
  • Data residency
+13 more
  • Enterprise Managed Users
  • User provisioning through SCIM
  • Enterprise Account to centrally manage multiple organizations
  • Environment protection rules
  • Repository rules
  • Audit Log API
  • SOC1, SOC2, type 2 reports annually
  • FedRAMP Tailored Authority to Operate (ATO)
  • SAML single sign-on
  • Advanced auditing
  • GitHub Connect
  • 50,000 CI/CD minutes/month
  • 50GB of Packages storage

Is Databox CLI worth the price?

Good value

The pricing is generous for individual developers and small teams, with a robust Free tier and a reasonable $4/user/month Team plan.

The Enterprise tier at $21/user/month is competitive for organizations needing advanced compliance and governance features. Best suited for developers and teams already invested in the GitHub ecosystem.

Hidden Costs & Gotchas

500MB Packages storage on Free

2GB Packages storage on Team

Full Databox CLI pricing: every plan, hidden costs and alternatives

Reviews

Improve Your Thinking Patterns Using ChatGPT cover
$99 Free with your review

Write the first Databox CLI review, get a free AI guide

Share your experience and we will send you Improve Your Thinking Patterns Using ChatGPT, free.

Write the first review

Explore More

Databox CLI FAQ

What timestamp format does the metric data command use?

The metric data command accepts dates in YYYY-MM-DD format for the --from and --to flags. Both days are inclusive in the query.

How do I find a data source ID?

You can list all data sources with 'databox data-source list' or see the ID returned by 'databox data-source create'. In the Databox app, the ID appears in the URL when you open the data source in Data Manager.

What is the difference between a data source ID and a dataset ID?

Data source ID and dataset ID are both numbers but occupy separate ID spaces. A data source contains datasets; each dataset has its own ID. You can list datasets with 'databox dataset list' or 'databox data-source datasets <source-id>'.

Can I use Databox CLI to push data into Databox?

Yes, the CLI supports dataset ingestion. The 'dataset ingest' command returns an ingestion ID, and you can list past ingestions with 'databox dataset ingestions <dataset-id>'.

Does the CLI support integration metrics like Google Analytics?

Yes, metric data can be read for integration metrics by passing the --source-id flag, since integration metric IDs don't contain the source ID. The metric list command provides the sourceId.

How do I upgrade from a 0.x version to 1.0?

The 1.0.0 migration guide lists every renamed command and flag. The CLI now targets the Databox V2 API, and dataset GUIDs from 0.x are no longer accepted; use dataset search instead.

What does the sync status in metric data output mean?

The sync status (shown as 'Sync: <status>' on stderr) indicates whether the metric was synced during the call. Statuses include 'synced', 'skipped', 'inProgress', and 'neverSynced'. It helps you know how current the metric values are.

Can I run Databox CLI commands from an AI agent?

Yes, the CLI is designed to be used by AI agents, as indicated in the README's 'Scripts and AI Agents' section. Commands are structured for scripted and automated invocation.

Source: github.com

Guides & Articles