Skip to main content

ABsmartly CLI

Command-line interface for AI agents and humans to manage experiments, feature flags, and A/B tests on the ABsmartly platform.

The CLI wraps the same Platform API used by the web console, so anything you can do in the dashboard, you can automate from a terminal or a script — listing and creating experiments, starting/stopping tests, managing metrics, teams, users, webhooks, and more.

Project status

This project is experimental. The core architecture is settled, but the API surface may change between releases.

Installation

bun install -g @absmartly/cli

Requires Bun >= 1.0 (or Node.js >= 18 at runtime).

Quick start

# Interactive setup wizard
abs setup

# Non-interactive setup
abs setup --api-key YOUR_KEY --endpoint https://your-instance.absmartly.com/v1

# Non-interactive setup with a named profile (e.g. for a read-only key)
abs setup --api-key YOUR_READONLY_KEY --endpoint https://your-instance.absmartly.com/v1 --profile readonly

# Or authenticate manually
abs auth login --api-key YOUR_API_KEY --endpoint https://your-instance.absmartly.com/v1

# Verify configuration
abs doctor

# List experiments
abs experiments list

# Get experiment details
abs experiments get 123

See Authentication for the full login flow, Configuration for global options and config file details, Experiments & Feature Flags for the primary command reference, Other Entities for goals/metrics/teams/admin commands, Experiment Templates for the markdown round-trip format, and Programmatic Usage if you want to call the CLI's core layer directly from TypeScript/JavaScript.