agent-workbench 0.8.1 → 0.9.1

package/README.md

@@ -18,6 +18,10 @@ npx agent-workbench
 
 ![A tour: the conversation as cards, the changed files and a diff, one tab per CLI, and continuing a conversation with another CLI](https://raw.githubusercontent.com/cvelasquez/agent-workbench/main/assets/demo.webp)
 
+<a href="https://youtu.be/C0Iea1cKQ7o"><img src="https://raw.githubusercontent.com/cvelasquez/agent-workbench/main/assets/video-tutorial.jpg" width="420" alt="Video tutorial on YouTube: five coding agents in one window"></a>
+
+▶ **[Video tutorial](https://youtu.be/C0Iea1cKQ7o)**: the whole app in 6 minutes, with chapters to jump straight to what you need.
+
 ## How it works
 
 Agent Workbench doesn't talk to any AI service. It starts the CLI you already
@@ -39,19 +43,21 @@ CLI.
 | **Fast start** | When you open the app, your tabs come back **asleep**: you can read them in full, and no CLI starts until you click **Open CLI**. |
 | **History** | Your projects and past conversations in the sidebar, from every CLI, with a filter. Click one to pick it up where you left it, with its CLI. Archive old sessions or a whole project to tidy up: nothing is deleted, and it can be undone. |
 | **Conversation** | The messages as cards, live, with tool calls folded. Older messages load as you scroll up. Search, copy any message or code block, and jump back to your previous message (↑) or to the end (↓). A row at the bottom says when your message reached the CLI and whether the agent is still working. Depending on the CLI, you can answer the agent's questions right there. A file of the project that the agent names opens in the Files tab with one click, and a folder, in the system's file explorer. With Claude Code, a message you stop before the agent starts comes back to the box so you can fix it, and **↩** on a message goes back to before it: the conversation and, if you want, the code. A message you send while the agent works waits at the end, marked as queued; depending on the CLI, **Force send now** makes the agent read it right away, and **Edit** (or ↑ in the empty box) brings it back to the box to fix it. |
-| **Message box** | Room to write, paste images, attach files, and long pasted text kept as a tidy chip. What you're typing survives closing the app, and shows up live in every open window. Shift+Enter continues a numbered or bulleted list. |
+| **Message box** | Room to write, paste images, attach files, and long pasted text kept as a tidy chip. What you're typing survives closing the app, and shows up live in every open window. Shift+Enter continues a numbered or bulleted list. The clock sends what you wrote on its own, on the day and at the time you choose, in the same conversation; turn it on in Settings (Antigravity CLI needs its status line). |
 | **Context meter** | How much of the model's context window the conversation is using. Tokens, never money. From 70%, **Compact** asks the CLI to compact the conversation. Next to it, with Claude Code, Codex and Antigravity CLI, how much of your plan's usage limits you've used and when they reset. |
-| **Changes** | The branch, the changed files and their diff. **Orchestrates agents in parallel**: open the project on a new branch, in its own folder, and several agents work at once without stepping on each other's changes. Changes shows every branch: what isn't committed yet, how many commits it has and whether it's merged. Another CLI reviews a branch without touching it, and you merge it into main with one click. |
+| **Changes** | The branch, the changed files and their diff. **Orchestrates agents in parallel**: open the project on a new branch, in its own folder, and several agents work at once without stepping on each other's changes. A conversation already under way moves to a new branch too, with all its context (with Claude Code, Codex and OpenCode). Changes shows every branch: what isn't committed yet, how many commits it has and whether it's merged. Another CLI reviews a branch without touching it, and you merge it into main with one click. |
 | **Files** | The project's file tree, with search and a preview with syntax highlighting. Open several files at once, each in its own tab; Markdown files open formatted. One click puts a file's path in your message. Edit a text file, a `.env` for instance, and save it right there: if the agent changed it while you were editing, nothing is overwritten, and you move your changes to the new version. |
 | **Plans** | The plans and `.md` documents the conversation wrote, rendered. One click puts a document's path in your message. |
-| **Notes** | A scratchpad next to the conversation, images included. With Claude Code, one click sends a note to a new conversation. |
+| **Notes** | A scratchpad next to the conversation, images included. **To message box** puts a note in the message box, to send it to the conversation you're in; with Claude Code, one click sends it to a new one. |
 | **Console** | Your system's terminal at the bottom, in the project's folder: PowerShell, cmd or Git Bash on Windows; bash or zsh on macOS and Linux. |
 | **Continue with…** | With more than one CLI, continue a conversation with another one in the same folder. The new agent starts from a transcript of the last turns. |
 | **Notifications** | A sound, and optional system notifications, when an agent finishes or is waiting for you. |
-| **Settings** | ⚙ in the header: the language, the terminal's theme, which panels show, which console opens and which CLIs the app uses. |
+| **Settings** | ⚙ in the header: the language, the terminal's theme, which panels show, which console opens, which CLIs the app uses and whether you can schedule messages. |
 | **Nine languages** | English, Español, 简体中文, 日本語, Português (Brasil), Русский, 한국어, Français and Deutsch. It follows your browser's language. |
 | **Theme** | Light, dark or the system's. The terminal stays dark by default, so the CLIs' colors stay readable. |
 
+With Codex, the conversation also offers model and permission controls, plans, and recognized questions and approvals. Available controls depend on your Codex version. Claude Code suggestions can be accepted in the message box.
+
 Optional, and off by default: [shared memory](#shared-memory-between-clis)
 between CLIs, a [backup](#backup-of-your-history) of your history, Claude
 Code's [plan usage limits](#claude-code-plan-usage-limits),
@@ -244,7 +250,8 @@ context meter:
 
 1. Open a Claude Code tab and click **Configure**, next to the meter.
 2. Copy the line it shows and add it to what `~/.claude/settings.json` already
-   has. The app doesn't edit that file: you do.
+   has. The app doesn't edit that file: you do. Or, with **Copy a request for
+   your agent**, ask an AI agent to add it for you.
 3. Within a couple of seconds, or with **Check**, the dialog says
    **Configured**. The limits show up with the next response.
 
@@ -269,7 +276,8 @@ unknown and the meters stay empty. To turn it on:
 1. Open an Antigravity tab and click **Configure**, next to the meter.
 2. Copy the line it shows and add it to what
    `~/.gemini/antigravity-cli/settings.json` already has. The app doesn't edit
-   that file: you do.
+   that file: you do. Or, with **Copy a request for your agent**, ask an AI
+   agent to add it for you.
 3. Within a couple of seconds, or with **Check**, the dialog says
    **Configured**.
 
@@ -406,6 +414,15 @@ picture of that QR code**. The phone remembers your computer's SSH fingerprint
 on the first connection, and if it ever changes, it refuses to connect and tells
 you.
 
+**Share a screenshot with your agent.** In any app, **Share → Agent Workbench**
+saves images (PNG, JPEG, GIF or WebP) and text to a note on your computer, a
+new one or one you pick, with a comment if you like. Then **To message box** on
+the note puts it in the conversation you choose. The phone keeps no copy.
+
+**If your computer's IP address changes**, **Settings → Change address** takes
+the new one, without pairing again. The app saves it only if your computer
+answers there, with its fingerprint.
+
 **To remove a phone**, **Revoke** it in the dialog and delete its line from
 `authorized_keys` (it ends in `agent-workbench-phone`). On the phone,
 **Settings → Forget this computer** deletes its key and its credential.
@@ -499,7 +516,7 @@ Pi's settings, or the `PI_TELEMETRY=0` environment variable.
 **What the app writes:**
 
 - **In its own configuration folder:** the open tabs, the index cache, the
-  notes, the archived sessions, unsent messages, the status line scripts of
+  notes, the archived sessions, unsent and scheduled messages (and, while it runs, a file with its process number, so two open copies don't send one twice), the status line scripts of
   Claude Code and Antigravity with what they save, the separate branches it
   created with a copy of each text note it copied into them (to merge the
   notes later) and, if you turn it on, the backup (or in the folder you