Usage

Monitor usage statistics using the usage command. View usage summary, available plans, usage history, and sandbox usage.

Command Syntax

hopx usage <subcommand> [options]

Subcommands

`summary`

View usage summary. Syntax:

hopx usage summary [OPTIONS]

Examples:

# View usage summary
hopx usage summary

Expected Output:

┌─────────────┬─────────────────────────────────────┐
│ Metric      │ Value                               │
├─────────────┼─────────────────────────────────────┤
│ Sandboxes   │ 15 / 100 (15%)                      │
│ Compute     │ 50h / 200h (25%)                    │
│ Storage     │ 5 GB / 50 GB (10%)                  │
│ Period      │ January 2025                        │
└─────────────┴─────────────────────────────────────┘

Exit Codes:

0 - Success
3 - Authentication error

`plans`

View available plans. Syntax:

hopx usage plans [OPTIONS]

Examples:

# View plans
hopx usage plans

Expected Output:

┌──────────────┬──────────────┬─────────────┐
│ Plan         │ Price       │ Features    │
├──────────────┼──────────────┼─────────────┤
│ Free         │ $0          │ 10 sandboxes│
│ Pro          │ $29/mo      │ 100 sandboxes│
│ Enterprise   │ Custom      │ Unlimited   │
└──────────────┴──────────────┴─────────────┘

Exit Codes:

0 - Success
3 - Authentication error

`history`

View usage history. Syntax:

hopx usage history [OPTIONS]

Options:

--limit INTEGER - Number of records to show
--output, -o FORMAT - Output format: table, json, plain (default: table)

Examples:

# View usage history
hopx usage history

# View with limit
hopx usage history --limit 20

Expected Output:

┌──────────────┬──────────────┬─────────────┐
│ Date         │ Sandboxes    │ Compute     │
├──────────────┼──────────────┼─────────────┤
│ 2025-01-27   │ 15           │ 2.5h        │
│ 2025-01-26   │ 12           │ 2.0h        │
└──────────────┴──────────────┴─────────────┘

Exit Codes:

0 - Success
3 - Authentication error

`sandboxes`

View sandbox usage statistics. Syntax:

hopx usage sandboxes [OPTIONS]

Options:

--output, -o FORMAT - Output format: table, json, plain (default: table)

Examples:

# View sandbox usage
hopx usage sandboxes

Expected Output:

┌──────────────┬──────────────┬─────────────┐
│ Sandbox ID   │ Runtime      │ Resources   │
├──────────────┼──────────────┼─────────────┤
│ sb_abc123    │ 2h 15m       │ 2 CPU, 4GB  │
│ sb_def456    │ 1h 30m       │ 1 CPU, 2GB  │
└──────────────┴──────────────┴─────────────┘

Exit Codes:

0 - Success
3 - Authentication error

CLI Quickstart - Get started with CLI
Billing - Manage billing
Organization Commands - Manage organizations

Next Steps

Learn about Billing to manage payments
Explore Organization Management to manage organization settings
Review Dashboard for detailed usage analytics

Getting Started

Setup

Commands

Command Syntax

Subcommands

`summary`

`plans`

`history`

`sandboxes`

Next Steps

​Command Syntax

​Subcommands

​summary

​plans

​history

​sandboxes

​Related

​Next Steps

Command Syntax

Subcommands

`summary`

`plans`

`history`

`sandboxes`

Related

Next Steps