From dcb203cb04259b74f66a5df14ec6720a23ea1007 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Mon, 20 Jul 2026 08:20:13 +0000
Subject: [PATCH] chore: auto-sync CLI docs and SKILL.md [skip release]

---
 .agents/skills/buttons/SKILL.md | 22 +++++++++++++++++
 docs/cli/buttons.md             |  2 ++
 docs/cli/buttons_login.md       | 44 +++++++++++++++++++++++++++++++++
 docs/cli/buttons_logout.md      | 38 ++++++++++++++++++++++++++++
 4 files changed, 106 insertions(+)
 create mode 100644 docs/cli/buttons_login.md
 create mode 100644 docs/cli/buttons_logout.md

diff --git a/.agents/skills/buttons/SKILL.md b/.agents/skills/buttons/SKILL.md
index 0517ff3..93093fb 100644
--- a/.agents/skills/buttons/SKILL.md
+++ b/.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
diff --git a/docs/cli/buttons.md b/docs/cli/buttons.md
index 34803d3..4e627d3 100644
--- a/docs/cli/buttons.md
+++ b/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
diff --git a/docs/cli/buttons_login.md b/docs/cli/buttons_login.md
new file mode 100644
index 0000000..a78bc03
--- /dev/null
+++ b/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
+
diff --git a/docs/cli/buttons_logout.md b/docs/cli/buttons_logout.md
new file mode 100644
index 0000000..b53b7c6
--- /dev/null
+++ b/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
+