Actory CLI

Official command-line interface for the Actory ACP API.

Installation

npm install -g @actory/cli

Quick Start

# Save your API key
actory login act_sk_your_key_here

# Search for products
actory search "red shoes"

# Natural language search
actory nl-search "shoes under $50 in stock"

# Get product details
actory product <product-id>

# List merchants  
actory merchants

Commands

actory login <api-key>

Save your API key for future requests.

actory login act_sk_abc123
actory login act_sk_abc123 --base-url http://localhost:3000

actory logout

Remove saved API key.

actory search <query>

Search the product catalog.

actory search "shoes"
actory search "shoes" --in-stock --max-price 100
actory search "nike" --vendor "Nike" --limit 20
actory search "shoes" --json  # Output as JSON

actory nl-search <query>

Natural language search with automatic parsing.

actory nl-search "red shoes under $50 in stock"

actory product <id>

Get details for a specific product.

actory product abc123
actory product abc123 --json

actory merchants

List all merchants in the network.

actory merchants
actory merchants --limit 50 --json

actory config

Show current configuration.

Output Formats

• Default: Pretty-printed colored output
• --json: Raw JSON output (for piping to other tools)

Configuration

API key is stored in ~/.config/actory/config.json.

Get an API Key

1. Visit actory.ai/keys
2. Create a new API key
3. Run actory login <your-key>

License

MIT