chore: auto-sync CLI docs from latest command changes

.agents/skills/buttons/SKILL.md

@@ -332,6 +332,28 @@ List all buttons
 buttons list
 ```
 
+### `buttons login`
+
+Connect this machine to the Buttons platform
+
+```
+buttons login [flags]
+```
+
+| Flag | Type | Description |
+|------|------|-------------|
+| `--desk` | string | Buttons console URL that hosts the authorization page |
+| `--no-browser` | bool | print the authorization URL instead of opening a browser |
+| `--registry` | string | registry base URL the token is issued for |
+
+### `buttons logout`
+
+Disconnect this machine from the Buttons platform
+
+```
+buttons logout
+```
+
 ### `buttons logs`
 
 View past runs for a button or tail the live progress stream

docs/cli/buttons.md

@@ -40,6 +40,8 @@ buttons [flags]
 * [buttons init](buttons_init.md)	 - Initialize a project-local .buttons directory
 * [buttons install](buttons_install.md)	 - Install packages from .buttons/buttons.json
 * [buttons list](buttons_list.md)	 - List all buttons
+* [buttons login](buttons_login.md)	 - Connect this machine to the Buttons platform
+* [buttons logout](buttons_logout.md)	 - Disconnect this machine from the Buttons platform
 * [buttons logs](buttons_logs.md)	 - View past runs for a button or tail the live progress stream
 * [buttons mcp](buttons_mcp.md)	 - Run an MCP server over stdio (expose buttons to agents)
 * [buttons press](buttons_press.md)	 - Run a button

docs/cli/buttons_login.md

@@ -0,0 +1,44 @@
+---
+title: "buttons login"
+description: "CLI reference for buttons login"
+---
+
+## buttons login
+
+Connect this machine to the Buttons platform
+
+### Synopsis
+
+Authorize this machine in your browser and store a publish token.
+
+Opens your Buttons console to approve the connection under your organization,
+then stores the issued token as the global REGISTRY_WRITE_KEY battery (used by
+"buttons publish") and pins the registry URL as the REGISTRY_URL battery.
+
+Revoke a machine any time from the console's Desks page.
+
+```
+buttons login [flags]
+```
+
+### Options
+
+```
+      --desk string       Buttons console URL that hosts the authorization page (default "https://desk.buttons.sh")
+  -h, --help              help for login
+      --no-browser        print the authorization URL instead of opening a browser
+      --registry string   registry base URL the token is issued for (default "https://api.buttons.sh")
+```
+
+### Options inherited from parent commands
+
+```
+      --json       output in JSON format
+      --no-input   disable all interactive prompts
+      --summary    show a read-only plan/snapshot instead of mutating
+```
+
+### SEE ALSO
+
+* [buttons](buttons.md)	 - Deterministic workflow engine for agents
+

docs/cli/buttons_logout.md

@@ -0,0 +1,38 @@
+---
+title: "buttons logout"
+description: "CLI reference for buttons logout"
+---
+
+## buttons logout
+
+Disconnect this machine from the Buttons platform
+
+### Synopsis
+
+Remove the stored publish token and registry URL.
+
+The token itself stays valid until revoked from the console's Desks page —
+logout only forgets it on this machine.
+
+```
+buttons logout [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for logout
+```
+
+### Options inherited from parent commands
+
+```
+      --json       output in JSON format
+      --no-input   disable all interactive prompts
+      --summary    show a read-only plan/snapshot instead of mutating
+```
+
+### SEE ALSO
+
+* [buttons](buttons.md)	 - Deterministic workflow engine for agents
+