From 069474e6aab8caec7e20a35f0687d2d62ba9a1d1 Mon Sep 17 00:00:00 2001 From: Ian Gulliver Date: Wed, 21 Oct 2026 11:58:15 -0700 Subject: [PATCH] Align documentation and user-facing terminology --- README.md | 2 +- docs/macos.md | 2 +- docs/operations.md | 1 - 3 files changed, 2 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index a2ad5fb..1835f4b 100644 --- a/README.md +++ b/README.md @@ -11,7 +11,7 @@ A server and macOS app for running many coding agents (Claude Code, Codex and An - **Snapshots and forks.** Step through a task's snapshots and diff any of them. Claude Code and Codex snapshots can also start a new task with the conversation included; Antigravity cannot fork conversations. - **Merge.** One click: the agent merges the default branch in and resolves conflicts, then byre squashes, pushes and closes the task, with co-author trailers and a git note recording the task. Merge after review, and one merge per project at a time with a queue. - **Subtasks and teams.** Agents can spawn subtasks on their own branches and merge them back, or several agents can share one worktree and talk through a board. -- **Workflows.** Named graphs of stages, each run as its own task, with fan-out and fan-in. +- **Workflows.** Named sequences of steps that run in order or in parallel, with each stage running as its own task. - **TODO.md.** A project's `TODO.md` items show in the Project tab; start or discuss one in a click. - **Changes, Files and Terminal.** Per-task diff view with line comments sent to the agent, a read-only file browser, and shells in the worktree, including ones that start by running a saved command. - **Previews.** Agents expose dev servers, and the app opens each at a local `*.localhost` address forwarded over the tailnet. diff --git a/docs/macos.md b/docs/macos.md index 257063d..2cdb66c 100644 --- a/docs/macos.md +++ b/docs/macos.md @@ -39,7 +39,7 @@ Every build is signed for distribution outside the App Store: the team's Develop ## Updates -The app runs Sparkle with its own user driver instead of Sparkle's standard windows, so no update UI offers Skip or turning automatic updates off, which `byre-update` would override. A Mac that runs the server but not the app is updated by `byre-update`, which the server runs daily; it does nothing while the app is running from that bundle, leaving the update to the app's own updater. +The update UI must not offer Skip or turning automatic updates off: on a Mac running the server, `byre-update` would override either choice while the app isn't running. ## Persistence diff --git a/docs/operations.md b/docs/operations.md index f0171fe..19adc0c 100644 --- a/docs/operations.md +++ b/docs/operations.md @@ -126,4 +126,3 @@ byre never signs with a key on the machine it runs on. When a project checkout's - Saved commands belong to a user on one server, because what they do is usually tied to that Mac: signing in again to the credential an `apiKeyHelper` uses (AppleConnect's `getToken -n cli` on a work Mac) is the case they were made for. Its terminal stays open after the command, so the result stays readable. - It types one byte per write: a program in raw mode that stops reading blocks a PTY write, and the PTY's file doesn't support deadlines, so this keeps the call within its limits while leaving at most one byte to arrive late. - zsh gets shell integration through a `.zshenv` in `/zsh` (via `ZDOTDIR`) that reports the prompt (OSC 133) and the line being edited, so byre can wake the agent when a line it left is run. It turns off `PROMPT_SP`, which would print a `%` padded to the width the shell started at, so an agent-opened shell (120 columns) replayed in a narrower tab wraps each one onto an extra line. A user `.zshrc` that sets `zle-line-pre-redraw` with `zle -N` rather than `add-zle-hook-widget` replaces the hook, and byre then sees the line as empty. Other shells get no integration and nothing wakes their agents. -- The terminal WebSocket checks that `Origin` matches `Host`, so another site can't open one through the user's Tailscale identity.