@staff0rd/assist 0.768.4 → 0.770.0

package/README.md

@@ -48,6 +48,7 @@ After installation, the `assist` command will be available globally. You can als
 - `/comment` - Add pending review comments to the current PR
 - `/commit` - Commit only relevant files from the session
 - `/devlog` - Generate devlog entry for the next unversioned day
+- `/extension` - Get the install link for the assist browser extension
 - `/draft` - Draft a new backlog item with LLM-assisted questioning
 - `/fix-conflict [--rebase]` - Resolve the current PR branch's conflicts against the remote default; `--rebase` rebases instead of merging
 - `/fix-rules [dir]` - Put existing rules into the `## Rules` format `assist rules` reads
@@ -326,7 +327,7 @@ Rules are `- **<code>** — **<title>** — <text>` bullets, the title optional,
 
 - `assist netcap [-p, --port <port>] [-o, --out <dir>] [-f, --filter <pattern>]` - Capture browser network traffic under `--out` (default `~/.assist/netcap`), paired with the [netcap browser extension](#netcap-browser-extension)
 - `assist netcap extract-linkedin-posts [file]` - Parse a netcap capture into structured LinkedIn posts
-- `assist criteria-extension [--sign]` - Locate the [acceptance criteria outliner extension](#acceptance-criteria-outliner-extension) to load unpacked; `--sign` signs it for a permanent Firefox install
+- `assist criteria-extension [--sign] [--url]` - Locate the [acceptance criteria outliner extension](#acceptance-criteria-outliner-extension) to load unpacked; `--sign` signs it for a permanent Firefox install; `--url` prints the latest signed build's download URL
 - `assist screenshot <process>` - Capture a screenshot of a running application window (`screenshot.outputDir`, default `./screenshots`)
 - `assist mermaid export [file.md]` - Render each fenced mermaid block to SVG via [Kroki](https://kroki.io) (`--out`, `--index`, `mermaid.krokiUrl`)
 - `assist prompts` - Show the most frequently denied tool calls
@@ -402,7 +403,15 @@ Web sessions are owned by a long-lived daemon process, not the web server: the s
 
 The topnav's **+** button (or Ctrl+N / Alt+N) opens the new-session dialog, which replaces the old draft / bug / prompt / design topnav buttons. Its mode selector picks `draft`, `bug`, `prompt` or `design`; in `prompt` mode a harness selector under it picks Claude, Codex or pi when those are exposed, and Up/Down moves between the two rows. `design` launches an interactive `claude` session with the vendored design system prompt appended via `--append-system-prompt`. Left/Right change the mode or harness, and Tab steps through a selector's options before moving on to the next control.
 
-Alt+1 to Alt+5 select the Nth visible top-level tab (with Releases hidden, News is Alt+4), including while the terminal has focus; on macOS use Option. Alt+A, Alt+S and Alt+D follow the main area left to right: Alt+A focuses the active session's sidebar card (expanding the sidebar and switching to Active), Alt+S focuses its terminal, and Alt+D opens and focuses its diff panel, or closes it back to the terminal when the diff already has focus; each returns to Sessions first. Alt+X opens the config page and Alt+C opens the menu. Ctrl+/ (Cmd+/ on macOS) or the menu's **Keyboard shortcuts** item opens a sheet listing every sessions-view shortcut. The top-level tabs, the new-session button, the active session's diff counts, the config cog and the menu button show their chord in their tooltip on hover and keyboard focus.
+Every hotkey is Alt plus a left-hand key, one keyboard row per screen region, and works while the terminal has focus; on macOS use Option.
+
+- **Numbers**: Alt+1 to Alt+5 select the Nth visible top-level tab (with Releases hidden, News is Alt+4).
+- **Q W E** (top right): Alt+W opens the config page and Alt+E opens the menu with focus on its first item. Alt+Q is reserved for the version item and does nothing yet.
+- **R** (toolbar): Alt+R focuses the toolbar's repo picker; Tab / Shift+Tab then move along the toolbar.
+- **A S D** (main area, left to right): Alt+A focuses the active session's sidebar card (expanding the sidebar and switching to Active), Alt+S focuses its terminal, and Alt+D opens and focuses its diff panel, or closes it back to the terminal when the diff already has focus. While the session's preview pane is open, Alt+D focuses the pane instead, and pressing it again returns focus to the terminal, leaving the pane open.
+- **Z X C** (session top bar): Alt+Z, Alt+X and Alt+C focus the active session's top-bar **Add agent**, **VS Code** and **Done** buttons; Tab / Shift+Tab then move to neighbouring top-bar buttons. A key whose button isn't shown does nothing.
+
+Keys whose target is on Sessions return there first. Ctrl+/ (Cmd+/ on macOS) or the menu's **Keyboard shortcuts** item opens a sheet listing every sessions-view shortcut. The top-level tabs, the new-session button, the repo picker, the top-bar add agent / VS Code / done buttons, the active session's diff counts, the config cog and the menu button show their chord in their tooltip on hover and keyboard focus.
 
 Every live session card carries an **add-agent** button (👥) that starts a second agent inside that session's existing workspace rather than allocating a new one. While several agents share a workspace, only the last one to leave triggers teardown.
 
@@ -553,7 +562,7 @@ Firefox release and beta only install signed add-ons, so a permanent install mea
 Signing runs in CI, so the AMO key lives only as repo secrets and never on a developer machine. One-time setup: create an AMO API key at [addons.mozilla.org/developers/addon/api/key](https://addons.mozilla.org/en-US/developers/addon/api/key/) and add its two halves as the repo secrets `AMO_JWT_ISSUER` (the `user:12345678:123` issuer) and `AMO_JWT_SECRET`. The **Criteria extension** workflow maps them onto the `WEB_EXT_API_KEY` / `WEB_EXT_API_SECRET` that `web-ext` reads.
 
 1. Run the **Criteria extension** workflow from the Actions tab (`gh workflow run criteria-extension.yml`). It checks out `main`, builds, signs the extension at assist's current version, and uploads the signed add-on to that version's GitHub release as `criteria-extension.xpi`. A failed AMO submission fails the job and attaches nothing.
-2. Download `criteria-extension.xpi` from the release — the URL follows from the version, `https://github.com/staff0rd/assist/releases/download/v<version>/criteria-extension.xpi`.
+2. Download `criteria-extension.xpi` from the release — the URL follows from the version, `https://github.com/staff0rd/assist/releases/download/v<version>/criteria-extension.xpi`. `assist criteria-extension --url` (or `/extension`) prints the latest signed build's URL, read from the update manifest on `main`.
 3. Open the `.xpi` in Firefox (drag it onto a window, or `about:addons` → gear → **Install Add-on From File…**). It survives restarts.
 
 AMO refuses a version it has already signed, which is why the staged manifest carries assist's version instead of the manifest's `1.0.0` placeholder — sign once per release, not twice at the same version.

package/claude/commands/extension.md

@@ -0,0 +1,19 @@
+---
+description: Get the install link for the assist browser extension
+---
+
+Run:
+
+```
+assist criteria-extension --url
+```
+
+It prints the download URL of the latest signed Firefox build. If it fails, report the error and stop.
+
+Show the link whole in the web preview pane:
+
+```
+printf '%s\n' '[Install the assist browser extension](<url>)' '' 'Open it in Firefox and accept the install prompt. Once installed, the add-on updates itself.' | assist show --title 'assist browser extension' --body -
+```
+
+Then reply with the URL and one line saying Firefox installs it permanently and keeps it updated.