starbridge 0.1.0 → 0.1.2

package/README.md

@@ -135,9 +135,19 @@ skill tells them when. `starbridge --help` lists every flag.
 starbridge pair
 ```
 
-It prints a code, a link and a QR code. Open the link in a browser where you are signed in, scan
-the QR code with your phone, or type the code in Settings → Devices → Add a device, on your phone
-or in the web app, which works from a machine with no browser. The code expires in 10 minutes.
+It prints a code, a link and a QR code. Scan the QR code with the Starbridge Android app or your
+phone's camera, open the link in a browser where you are signed in, or type the code in
+Settings → Devices → Add a device, on your phone or in the web app, which works from a machine
+with no browser. The code expires in 10 minutes.
+
+The QR code is a `starbridge://` link that only the Android app opens, and it carries a check
+key with which the app confirms the machine's check code by itself. Approved any other way, the machine prints its check
+code and asks whether the Android app shows the same beside it under Devices: press Enter if so, `n` if not.
+Where setup runs with no terminal, run `starbridge pair --confirm`, or `starbridge pair --reject`
+if the codes differ. A code that differs means a server read your pairing code and paired the
+machine into an account it controls ([PROTOCOL.md](../PROTOCOL.md#pairing)); the machine then
+saves nothing.
+
 The machine pairs with
 https://starbridge.run unless you pass `--server https://starbridge.example` or set
 `STARBRIDGE_SERVER`.
@@ -221,6 +231,21 @@ To upload without the service:
 starbridge quota push --provider claude --provider codex
 ```
 
+### Quiet the phone while you're here
+
+On a desktop or laptop you work at, turn on presence:
+
+```bash
+starbridge config presence on
+```
+
+While this machine's screen is unlocked and had keyboard or mouse input in the last minute,
+notifications on your other devices wait for the time set in Starbridge's Settings (30 s by
+default) and come only if the question is still open, so one you answer here doesn't buzz your
+phone. The question itself shows everywhere at once. The machine reads its lock and idle time
+itself and tells the server only yes or no. It works on macOS, Windows, and Linux under GNOME
+or X11 with `xprintidle`; a machine with no screen sends nothing.
+
 ### Permission prompts
 
 Permission prompts from Claude Code, opencode and Pi stay at the keyboard until you turn them on
@@ -264,9 +289,10 @@ Keys and state live in `~/.config/starbridge` (or `$XDG_CONFIG_HOME/starbridge`,
 `$STARBRIDGE_CONFIG_DIR`), readable only by you. `starbridge config` prints this machine's
 settings.
 
-The Claude Code plugin's hooks call `starbridge hook …`. One of them turns Claude Code's
-`AskUserQuestion` into `starbridge ask`, so the question reaches you away from the terminal; if
-the machine is not paired or the server doesn't answer, it lets the question through. The
+The Claude Code plugin's hooks call `starbridge hook …`. When Claude Code opens its
+`AskUserQuestion` picker, `starbridge hook permission` posts the question to your devices too:
+the first answer, in the picker or on a device, wins, and the other closes as answered
+elsewhere. If the machine is not paired or the server can't be reached, only the picker asks. The
 opencode plugin runs `starbridge hook question --agent opencode` on each call of opencode's
 `question` tool: it posts each question to your devices and prints the answers for opencode,
 or nothing if the terminal answers first or the server can't be reached.