Command-Line Interface (CLI)

The CryptohopperAI CLI

The cryptohoppercommand-line interface lets you create, deploy, and manage your Cryptohopper.AI projects straight from your terminal — ideal for power users, scripting, and CI/CD. It talks to the same Public API the web app uses.

It is open source and ships as a single self-contained binary (no runtime to install) from github.com/cryptohopper/cryptohopperai-cli.

Install

The quickest way is the CLI download page, which auto-detects your platform. Or grab the binary for your OS directly:

macOS (Apple Silicon)

curl -fsSL -o cryptohopper https://github.com/cryptohopper/cryptohopperai-cli/releases/latest/download/cryptohopper-darwin-arm64
chmod +x cryptohopper
sudo mv cryptohopper /usr/local/bin/

macOS (Intel) — same steps with cryptohopper-darwin-x64.

Linux (x64)

curl -fsSL -o cryptohopper https://github.com/cryptohopper/cryptohopperai-cli/releases/latest/download/cryptohopper-linux-x64
chmod +x cryptohopper
sudo mv cryptohopper /usr/local/bin/

Windows (x64) — download cryptohopper-windows-x64.exe from the Releases page, rename it to cryptohopper.exe, and place it on your PATH.

Verify with cryptohopper --version. To update later, run cryptohopper upgrade— it replaces the binary with the latest release in place.

Authenticate

Authorize the CLI on this device. It opens your browser to confirm and stores a device token locally:

cryptohopper login

Check who you are signed in as with cryptohopper whoami, and sign out with cryptohopper logout. Device login works with any active Cryptohopper subscription.

Create & manage projects

# Create a project from a prompt and wait for it to go live
cryptohopper new "A BTC/USDT grid trading bot with a live P&L dashboard"

# List your projects
cryptohopper list

# Check build status (by id or subdomain)
cryptohopper status btc-grid-bot

# Open the live project in your browser
cryptohopper open btc-grid-bot

# Refine a project in an interactive chat
cryptohopper chat btc-grid-bot

Other project commands include cancel, reactivate, conversations (chat history), and usage (your plan, credit balance, and current-period usage).

Project secrets

Set write-only environment variables (exchange API keys, config) that your deployed project reads at runtime — see Project Secrets:

cryptohopper secrets set my-bot EXCHANGE_API_KEY --value "..."
cryptohopper secrets list my-bot
cryptohopper secrets rm my-bot EXCHANGE_API_KEY

API keys for CI/CD

Device login is interactive. For unattended use (CI/CD, servers), create a programmatic API key and pass it via an environment variable. Account API keys require an active Hero subscription:

# Create a key (shown once — copy it immediately)
cryptohopper keys create "ci-pipeline"

# Use it without an interactive login
export CRYPTOHOPPER_TOKEN="flp_your_api_key_here"
cryptohopper list

See Managing API Keys and Authentication for details.

Shell completion

Enable tab-completion for commands and subcommands. For example, in bash:

echo 'source <(cryptohopper completion bash)' >> ~/.bashrc

cryptohopper completion also supports zsh, fish, and powershell — run cryptohopper completion <shell> and follow the printed install hint.

Configuration

The CLI stores its token and settings under ~/.cryptohopper. Two environment variables override the defaults:

• CRYPTOHOPPER_TOKEN— bypass the stored token entirely (use a device token or an API key); ideal for CI and scripts.
• CRYPTOHOPPER_API_URL— point the CLI at a different API base (defaults to https://www.cryptohopper.ai).

Run cryptohopper --help for the full command list, or cryptohopper docs to open this reference in your browser.