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

​
Account management

​
zam wallet create

Create a new ZAM account. Solves a proof-of-work challenge and returns your wallet address, API key, and recovery phrase. 
zam wallet create
The API key is automatically saved to ~/.zam/config.json. The recovery phrase is shown only once — save it securely.

​
zam wallet recover

Recover your account using your 12-word recovery phrase. Revokes all existing API keys and issues a new one. 
zam wallet recover

​
zam auth approve

Approve a device code from the dashboard for signing in on another device. Requires an existing API key. 
zam auth approve

​
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.am
# Manually set an API key (if not using wallet create)
zam config set-key zam_your_key_here

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

# 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 search weather --show-schema
Use --show-schema to include the full input/output schemas for each listing in the results. This is useful for discovering what parameters a listing expects before activating it.

​
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 providers

Create and manage your services on the marketplace. All subcommands require authentication. 
zam providers create                      # Interactive provider creation
zam providers create-from-service <url>   # Import from a /contract endpoint
zam providers list                        # List all your providers
zam providers get <id>                    # Show one provider in detail
zam providers update <id>                 # Interactive provider update
zam providers delete <id>                 # Delete (with confirmation)

​
zam listings

Browse and manage marketplace listings. All subcommands require authentication. 
zam listings list              # List all your listings
zam listings get <id>          # Show one listing in detail
zam listings update <id>       # Interactive listing update
zam listings delete <id>       # Delete (with confirmation)

​
Signing secrets

Manage HMAC signing secrets for your listings. These secrets let you verify that incoming requests genuinely come from ZAM. 
zam listings get-secret <id>       # Check if a signing secret exists
zam listings rotate-secret <id>    # Rotate the signing secret (with confirmation)
See Secure Your Service for how to use signing secrets in your service.

​
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 providers
  • 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 providers create always require manual approval. The command is idempotent — running it again updates skill files and the hook in place.