Documentation Index
Fetch the complete documentation index at: https://docs.zeroclick.am/llms.txt
Use this file to discover all available pages before exploring further.
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.
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 auth approve
Approve a device code from the dashboard for signing in on another device. Requires an existing API key.
Configuration
The CLI stores settings in ~/.zam/config.json. Environment variables take precedence over stored values.
| Setting | Env variable | Default |
|---|
| API key | ZAM_API_KEY | (none) |
| API URL | ZAM_API_URL | https://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
--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
| Flag | Default | Description |
|---|
--request-body <json> | (none) | JSON string passed as the order’s request body |
--timeout <seconds> | 10 | How long to poll before giving up |
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)
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)
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.
Supported tools:
| Tool | Detected via |
|---|
| Claude Code | ~/.claude/ |
| Codex | ~/.codex/ |
| OpenCode | ~/.config/opencode/ |
| Cursor | ~/.cursor/ |
- 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.
