Skip to main content
adside brings Adside to your terminal: campaigns, creatives, assets and reporting across your ad accounts, for you or for an AI agent working with you.

​
Install

It needs Node.js 22 or later, on macOS, Linux or Windows.

​
Log in

Your browser opens Adside. Approve “Adside CLI” once, and the terminal is logged in. On a computer without a browser, over SSH for example, run adside login --no-browser. Open the link on any device and paste the code it shows.

​
Choose a workspace

With several workspaces, adside login asks which one commands use by default. Change it at any time:
Check where you are:

​
Your login

The login is kept in your operating system’s credential store: the macOS Keychain, the Windows Credential Manager or the Secret Service on Linux. Where there is none, it is kept in ~/.config/adside/credentials.json, readable only by you. It stays valid while you use it at least once every 30 days.
  • adside logout ends it on this computer.
  • In Adside, Settings, then Sessions, lists every computer where you are logged in. Revoke one, and commands there stop working within 15 minutes.
To keep logins apart, save one under a name with adside login --profile <name>, and select it with the ADSIDE_PROFILE environment variable.

​
In CI or on a server

Set ADSIDE_API_KEY to a personal API key instead of logging in. A key in ADSIDE_API_KEY comes before a stored login, and adside whoami shows which one is in use. A key acts as the person who created it, with their permissions.

​
Next