Authentication

Anonymous Deploys (No Account Required)

You can deploy without logging in. Anonymous deploys:

• Return a claim_token and claim_url alongside the live URL
• Expire after 24 hours if not claimed
• Can be associated with your account via POST /deploy/claim

This is useful for quick experiments or when you want to try Invoker before creating an account.

First-Time Login

To deploy persistently (no expiry), sign in:

1. Browser opens — Invoker opens your default browser to the sign-in page
2. Enter your email — type your email address
3. Verify — enter the one-time code sent to your inbox
4. Done — credentials are saved locally for future requests

The entire flow takes about 15 seconds.

Ask Claude to trigger it:

"Log me in to Invoker"

Claude calls the login tool, which opens your browser automatically.

Credentials Storage

After login, your credentials are saved to:

~/.invoker/credentials.json

This file contains your email address and an API key. Subsequent requests authenticate automatically without re-prompting.

WARNING

credentials.json contains your API key. Do not commit it to version control or share it. The default location (~/.invoker/) is in your home directory, outside any project.

Environment Variable

For CI/CD pipelines or headless environments where a browser isn't available, set an API key directly:

export INVOKER_API_KEY=inv_your_api_key_here

When this variable is set, Invoker skips the browser login and authenticates directly with the provided key. API keys can be generated from the Invoker dashboard.

Check Auth Status

Ask Claude:

"Who am I signed in as on Invoker?"

This calls the whoami tool and returns your email address.

Logout

Ask Claude:

"Log me out of Invoker"

This calls the logout tool, deleting your stored credentials. You'll need to sign in again for future authenticated deployments.

Next Step

Ready to go — continue to First Deploy to create your first live page.