Authentication

Invoker requires authentication to deploy pages and manage submissions. The first time you use it, Claude will walk you through a browser-based sign-in flow.

First-time login

When you ask Claude to deploy something for the first time, it calls the login tool automatically. Here is what happens:

1. Browser opens -- Invoker opens your default browser to the sign-in page
2. Enter your email -- you provide your email address
3. Verify with OTP -- a one-time code is sent to your email; enter it in the browser
4. Credentials stored -- on success, your credentials are saved locally

The entire flow takes about 15 seconds.

Claude: I'll deploy that for you. Let me sign in first.
→ [login tool called]
→ Browser opens to invoker.page/auth
→ You enter email + OTP code
→ "Signed in as you@example.com"

Where credentials are stored

After login, your credentials are saved at:

~/.invoker/credentials.json

This file contains your email address and an API key. It is used automatically on subsequent requests -- you will not need to log in again unless you explicitly log out or delete the file.

Keep this file private

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

As an alternative to the browser login flow, you can set the INVOKER_API_KEY environment variable:

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. This is useful for CI/CD pipelines or headless environments where a browser is not available.

You can find your API key in ~/.invoker/credentials.json after a successful browser login, or generate one from the Invoker dashboard.

Checking your auth status

Ask Claude to check who is signed in:

"Who am I signed in as on Invoker?"

Claude calls the whoami tool and returns your email address and account status.

Logging out

To clear your stored credentials:

"Log me out of Invoker"

Claude calls the logout tool, which deletes ~/.invoker/credentials.json. You will need to log in again on your next deploy.

Next step

First Deploy -- put a page live in under a minute.