adside 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,48 @@
-# Temporary Holding Version
+# adside
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Adside from your terminal: campaigns, creatives, assets and reporting across your ad accounts, for you or for an AI agent working with you.
+
+## Install
+
+```bash
+npm install -g adside
+```
+
+Node.js 22 or later, on macOS, Linux or Windows.
+
+## Log in
+
+```bash
+adside login
+```
+
+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.
+
+With several workspaces, `adside login` asks which one commands use by default. Change it at any time:
+
+```bash
+adside use                # list your workspaces
+adside use "Acme"         # by name or ID
+```
+
+## Use
+
+```bash
+adside whoami
+adside --help             # every area
+adside assets --help      # the commands of an area, with their flags
+adside assets list
+```
+
+Commands print JSON; add `--output text` for a summary to read.
+
+## 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 → Sessions** lists every computer where you are logged in, and revokes any of them.
+
+## License
+
+Proprietary. © Adside, all rights reserved.