Docs

Agent Quickstart

Authorize a coding agent once, then let it create a Zoneless store without copying API keys into a prompt.

1Start agent setup

Ask your agent to run the CLI from the project where it will build your store. The CLI generates encryption keys locally and sends Zoneless only the RSA public key and wallet public key.

Terminal
npx @zoneless/cli@latest agent setup --platform-name "Acme"

2Approve once

Open the activation URL printed by the CLI, sign in or create an account, and review the platform name, wallet public key, requested capabilities, and expiry. Click Approve only if they match the setup you started.

3Keep credentials out of prompts

Zoneless encrypts each credential bundle with AES-256-GCM and encrypts that one-time AES key with the CLI RSA public key. The CLI decrypts the response locally and stores secrets in the operating system credential store.

Running agent setup again with valid local profiles reuses them without changing API keys or wallets. If local credentials are lost, run setup again and choose Reconnect on the approval page. Reconnecting keeps the existing payout wallet and replaces only its previous agent API key.

To create another isolated platform with its own wallet, credentials, and dashboard, run npx @zoneless/cli@latest agent setup --platform-name "Second Store" --new-platform. The CLI chooses a collision-free live/test profile prefix unless one is provided.

4Give the agent its task

After approval, the agent can use the Zoneless store skill and CLI to create a product, price, and payment link, then add the checkout URL to your site.

Agent prompt
Set up a Zoneless store called Acme and sell a product for $2 USDC. Run `npx @zoneless/cli@latest agent setup --platform-name §A§`; pause only when I need to authorize ownership, then finish the site using the zoneless-store skill.