Skip to main content
The ZAM CLI wraps the REST API in an interactive terminal interface. Install it globally: 
npm install -g zam-cli@latest

​
Configuration

The CLI stores settings in ~/.zam/config.json. Environment variables take precedence over stored values.
SettingEnv variableDefault
API keyZAM_API_KEY(none)
API URLZAM_API_URLhttps://api.zeroclick.quest
# Store your API key
zam config set-key zam_your_key_here

# Point to a different API server
zam config set-url https://api.zeroclick.quest

# Show current configuration
zam config show

​
Commands

​
zam search [query]

Search the public marketplace. No authentication required. 
zam search weather
zam search --category data
zam search --tag forecast

​
zam activate <listingId>

Activate a listing and poll for the result. Requires order:create scope. 
zam activate LISTING_ID
zam activate LISTING_ID --request-body '{"city": "SF"}'
zam activate LISTING_ID --timeout 30
FlagDefaultDescription
--request-body <json>(none)JSON string passed as the order’s request body
--timeout <seconds>10How long to poll before giving up
If the order is still running when the timeout expires, the CLI prints the order ID and suggests zam orders get <id>.

​
zam listings

Manage your own listings. All subcommands require authentication. 
zam listings list              # List all your listings
zam listings get <id>          # Show one listing in detail
zam listings create            # Interactive listing creation
zam listings update <id>       # Interactive listing update
zam listings delete <id>       # Delete (with confirmation)
zam listings create-from-service <url>  # Import from a /contract endpoint

​
zam orders

View your order history. Requires order:read scope. 
zam orders list       # List all orders
zam orders get <id>   # Show one order in detail

​
zam api-keys

Manage API keys. Requires api_key:* scopes. 
zam api-keys list          # List all keys
zam api-keys create        # Interactive key creation
zam api-keys update <id>   # Update name or scopes
zam api-keys delete <id>   # Revoke (with confirmation)
When you create a key, the CLI prints the full plaintext key once. Copy it immediately.

​
zam openapi

Inspect the ZAM API spec. No authentication required. 
zam openapi          # Print endpoint summary table
zam openapi --raw    # Dump full OpenAPI JSON

​
zam agents install

Install ZAM skills for AI coding agents. Detects supported tools in your home directory and copies skill files that teach your agent how to search, create, and activate Zams. 
zam agents install
Supported tools:
ToolDetected via
Claude Code~/.claude/
Codex~/.codex/
OpenCode~/.config/opencode/
Cursor~/.cursor/
For each detected tool, three skill files are installed:
  • zam-search — how to search the marketplace
  • zam-create — how to create and manage listings
  • zam-activate — how to activate listings and check order status
For Claude Code, the command also installs an auto-approval hook at ~/.zam/hooks/auto-approve-zam.sh that auto-approves read-only ZAM operations (zam search, zam orders list, zam orders get, zam openapi, zam config show). Destructive operations like zam activate and zam listings create always require manual approval. The command is idempotent — running it again updates skill files and the hook in place.

​
zam config

Manage CLI configuration. 
zam config show        # Print current settings
zam config set-key     # Set API key (interactive if no argument)
zam config set-url     # Set API URL (interactive if no argument)