Authentication

A single Google sign-in gives you access to all of OrbiAds — CLI, MCP and Skills. Credentials are encrypted locally, no password is stored.

Sign in in 6 steps

The CLI uses OAuth 2.0 Device Flow: no need to open a browser on the same machine. Ideal for servers, CI/CD and headless environments.

Run the sign-in command

$ orbiads auth login

A code and URL appear in the terminal

Open the URL in any browser (any device)

Enter the code and authorize with your Google account

OrbiAds receives access to your GAM networks

The token is encrypted and stored — you're signed in

Terminal

$ orbiads auth login
Authenticating with OrbiAds...
Please visit:  https://orbiads.com/device
Enter code:    ABCD-1234

Waiting for authorization...
Authenticated as jlalbany@gmail.com
Network: My Ad Network (66235823)
Token saved to ~/.orbiads/credentials.json

Security & storage

Token stored in ~/.orbiads/credentials.json, encrypted at rest. Never transmitted in plaintext.

The refresh token renews automatically — no manual re-authentication.

Revoke access anytime: orbiads auth logout removes local credentials.

No password stored. Authentication relies solely on Google OAuth 2.0.

Authentication commands

orbiads auth login

Starts the Device Flow. Displays a link in the terminal, you authorize on Google, the CLI receives the token.

orbiads auth logout

Removes local credentials and revokes access.

orbiads auth status

Shows the connected account, active GAM network and token expiration.

After sign-in: Skills

Once signed in, all 8 OrbiAds Skills are available. Each Skill is an operational context that guides AI step by step — action order, checks, business rules. AI knows how to use the tools, Skills save it from figuring out how.

Discover all 9 Skills