agent-workbench 0.1.0 → 0.3.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Christian Velasquez
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Christian Velasquez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,219 +1,424 @@
 # Agent Workbench
 
-Una interfaz visual local para la CLI de Claude Code.
+[![npm](https://img.shields.io/npm/v/agent-workbench)](https://www.npmjs.com/package/agent-workbench)
+[![CI](https://github.com/cvelasquez/agent-workbench/actions/workflows/ci.yml/badge.svg)](https://github.com/cvelasquez/agent-workbench/actions/workflows/ci.yml)
+[![license: MIT](https://img.shields.io/npm/l/agent-workbench)](LICENSE)
 
-No habla con ninguna API. Lanza el binario `claude` que ya tenés instalado y
-logueado, dentro de una pseudo-terminal, y le agrega alrededor lo que una
-terminal sola no da: pestañas, historial navegable, la conversación como
-tarjetas, un medidor de contexto, el estado de git y un árbol de archivos.
+**One local interface for the Claude Code, Codex, OpenCode and Antigravity
+CLIs.** It uses the CLIs you already have logged in, never touches your
+credentials, and makes no network calls of its own.
 
-La terminal sigue siendo la terminal. Todo lo que escribís le llega a la CLI sin
-que la aplicación lo toque.
+```bash
+npx agent-workbench
+```
+
+It doesn't talk to any API. It launches the CLI you already have installed and
+logged in —`claude`, `codex`, `opencode` or `agy`— inside a pseudo-terminal, and
+adds around it what a terminal alone doesn't give you: tabs, browsable history,
+the conversation as cards, a context meter, git status and a file tree.
+
+The terminal is still the terminal. Everything you type reaches the CLI without
+the app touching it.
 
-![La conversación al centro; alrededor, los proyectos con su historial, las pestañas y el árbol de archivos](https://raw.githubusercontent.com/cvelasquez/agent-workbench/main/docs/captura-conversacion.png)
+![The conversation in the center; around it, the projects with their history, the tabs of the four CLIs and the file tree](https://raw.githubusercontent.com/cvelasquez/agent-workbench/main/assets/captura-conversacion.png)
 
 ---
 
-## Qué hace
+## What it does
 
 | | |
 |---|---|
-| **Pestañas** | Varias sesiones vivas a la vez, cada una en su directorio. Sobreviven a un `F5`: los procesos viven en el servidor, no en la pestaña del navegador. |
-| **Historial** | Tus proyectos y conversaciones anteriores en la barra lateral, con filtro. Abrir una la retoma con `--resume`, en el mismo archivo. |
-| **Conversación** | Los mensajes de la sesión activa, en vivo, con las herramientas plegadas y su resultado adentro. Búsqueda, salto entre resultados y copiado por mensaje. |
-| **Medidor de contexto** | Tokens de la última petición contra la ventana del modelo. Tokens, nunca dinero. |
-| **Cambios** | Rama, adelanto y atraso contra la rama de seguimiento, worktrees, y los archivos tocados con su diff. **Solo lectura.** |
-| **Archivos** | El árbol del directorio de la pestaña, con carga perezosa y previsualización con resaltado de sintaxis. Menú contextual para copiar rutas, insertarlas como `@ruta` o abrir el archivo con la app del sistema. |
-| **Tema** | Claro, oscuro, o el del sistema. |
+| **Tabs** | Several live sessions at once, from any of the CLIs, each in its own directory. They survive an `F5`: the processes live on the server, not in the browser tab. Each tab's dot tells you whether the agent is working, idle or waiting for an answer, on the CLIs that publish their status ([below](#multiple-clis)). |
+| **Zero-cost startup** | When you open the app, tabs come back as **sleeping tabs**: you can read them in full, and they don't launch any CLI. You open the CLI with a button when you want to write to the agent. |
+| **History** | Your projects and past conversations in the sidebar, with a filter, and those of all four CLIs together under each project, each with its badge. Opening one resumes it with its CLI, in the same session. **Archive history…** hides a CLI's sessions from before today in one go, and each project can be archived whole with one button: nothing is deleted, and both can be undone. |
+| **Conversation** | The active session's messages, live, with tool calls collapsed and their results inside. Search, jump between matches, copy any message and, depending on the CLI, answer the agent's questions from the chat. |
+| **Continue with…** | With more than one CLI installed, a conversation can be continued with another CLI in the same folder. The new agent starts from a transcript of the last turns, not from the context the previous one had. |
+| **Search everything** | With more than one CLI and something saved in the local copy, the sidebar filter also searches the text of every saved conversation, not just their titles. |
+| **Context meter** | Tokens from the last request against the model's context window. Tokens, never money. |
+| **Changes** | Branch, ahead and behind against the upstream branch, worktrees, and the changed files with their diff. **Read-only.** |
+| **Files** | The tree of the tab's directory, with search by name and a preview with syntax highlighting. A context menu to copy paths, insert them as `@path` or open the file with the system's default app. |
+| **Plans** | The documents written by that conversation, rendered: the plans from plan mode, and also the `.md` files the agent created inside the project or in the session's temp folder. Only those named by the conversation you're viewing. |
+| **Shared memory** | What agents learn about a project, in `.agents/memory/`, read and written by all four CLIs ([below](#shared-memory)). |
+| **Local copy** | Optional. The history of all four CLIs in a folder of yours, in the app's own format, so you don't lose it if a CLI changes its format, deletes it, or you uninstall the CLI ([below](#local-copy-optional)). |
+| **Nine languages** | The interface in English, Español, 简体中文, 日本語, Português (Brasil), Русский, 한국어, Français and Deutsch. It follows the browser's language and can be changed from the header, without reloading. |
+| **Theme** | Light, dark, or the system's. |
 
 <p>
-  <img src="https://raw.githubusercontent.com/cvelasquez/agent-workbench/main/docs/captura-cambios.png" width="49%" alt="El panel de cambios: rama y archivos tocados, por grupo">
-  <img src="https://raw.githubusercontent.com/cvelasquez/agent-workbench/main/docs/captura-diff.png" width="49%" alt="El diff de uno de esos archivos, en el mismo panel">
+  <img src="https://raw.githubusercontent.com/cvelasquez/agent-workbench/main/assets/captura-cambios.png" width="49%" alt="The Changes panel: branch and changed files, by group">
+  <img src="https://raw.githubusercontent.com/cvelasquez/agent-workbench/main/assets/captura-diff.png" width="49%" alt="The diff of one of those files, in the same panel">
 </p>
 
+### Multiple CLIs
+
+With more than one CLI installed, every session in the sidebar and every tab
+carries its CLI's badge, and the new-tab `+` opens with the one you used in that
+project; its arrow lets you pick another. With just one, you see none of this.
+
+<img src="https://raw.githubusercontent.com/cvelasquez/agent-workbench/main/assets/captura-clis.png" width="45%" alt="The projects sidebar with sessions from several CLIs, each with its badge, and the + menu with the four CLIs and their versions">
+
+**Not every CLI exposes the same things.** Claude Code leaves everything the app
+needs in its files. Codex leaves the history and the meter's tokens, but not its
+status, its pending permissions, its questions or the model: its dot says the
+status is unknown, there's no "waiting" notice and questions are answered in its
+terminal. With OpenCode, the app starts a local OpenCode server when you open a
+tab, and that's where its status, the notice that it's waiting for a permission
+and the questions you answer from the chat come from. Antigravity CLI publishes
+its status and tokens only if you configure its status line
+([below](#antigravity-cli-status-and-meter-optional)).
+
 ---
 
-## Requisitos
+## Requirements
 
 | | |
 |---|---|
-| **Node.js** | 20 o superior |
-| **git** | para el panel de cambios; el resto funciona sin él |
-| **La CLI de Claude Code** | instalada y con sesión iniciada — [guía de instalación](https://docs.claude.com/en/docs/claude-code/setup) |
-
-Agent Workbench **no** incluye la CLI ni la descarga: usa la que ya tenés en el
-`PATH`. Si no la encuentra, te lo dice y no abre sesiones.
-
-Probado sobre Windows 11 con PowerShell, que es la plataforma principal.
-macOS y Linux funcionan igual. En Linux, la dependencia `node-pty` no trae
-binario precompilado y se compila al instalar: hacen falta `python3`, `make` y
-un compilador de C++ (`build-essential` en Debian y Ubuntu).
+| **Node.js** | 20 or later. **To see the OpenCode history and the Antigravity CLI titles, 22.13 or later**: they're read with the SQLite that Node ships since that version. With an older one everything else works the same; the startup output warns about OpenCode, and Antigravity CLI lists its conversations without the titles or folders from its index |
+| **git** | for the Changes panel; everything else works without it |
+| **At least one CLI** | installed and logged in (table below) |
+
+| CLI | Command | Installation |
+|---|---|---|
+| Claude Code | `claude` | [installation guide](https://docs.claude.com/en/docs/claude-code/setup) |
+| Codex | `codex` | [guide](https://learn.chatgpt.com/docs/codex/cli) |
+| OpenCode | `opencode` | [documentation](https://opencode.ai/docs/) |
+| Antigravity CLI | `agy` | [guide](https://antigravity.google/docs/cli/getting-started). For its status and meter, also `node` in the CLI's `PATH` |
+
+Agent Workbench does **not** bundle or download any CLI: it uses the ones you
+already have in your `PATH`. If it doesn't find any, it tells you so and doesn't
+open sessions.
+
+Tested on Windows 11 with PowerShell, which is the main platform. macOS and
+Linux work the same. On Linux, the `node-pty` dependency doesn't ship a prebuilt
+binary and is compiled on install: you need `python3`, `make` and a C++ compiler
+(`build-essential` on Debian and Ubuntu).
 
 ---
 
-## Instalar
+## Install
 
 ```bash
 npm install -g agent-workbench
 ```
 
-Después, parado en el proyecto en el que quieras trabajar:
+Then, from the folder of the project you want to work on:
 
 ```bash
 agent-workbench
 ```
 
-Para probarlo una vez sin instalarlo, `npx agent-workbench` — baja unos 60 MB
-cada vez que la caché de npm está fría, casi todo del binario de la terminal.
-Para uso diario conviene la instalación global.
+To try it once without installing it, `npx agent-workbench` — it downloads about
+60 MB whenever the npm cache is cold, mostly the terminal's native binary. For
+daily use, the global install is the better choice.
 
-El servidor imprime una URL con un token y la abre en el navegador:
+The server prints a URL with a token and opens it in the browser:
 
 ```
   URL          http://127.0.0.1:52341/?token=…
 ```
 
-Esa URL es la única forma de entrar. El token es distinto en cada arranque, y el
-servidor escucha solo en `127.0.0.1`.
+That URL is the only way in. The token is different on every start, and the
+server listens only on `127.0.0.1`.
+
+### Shared memory
+
+Each CLI keeps what it learns about a project in its own folder, and the others
+can't see it. The **Memory** tab installs a bridge so all four use the same one:
+notes in the project's `.agents/memory/`, which each CLI reads and writes —from
+here or from its own terminal— through `AGENTS.md` and `CLAUDE.md`.
+
+**Preview changes** shows, file by file, what will be written, and nothing is
+touched until you confirm. Installing imports the memory Claude Code already had
+for that project. The app doesn't write each CLI's global memory: it gives you
+the snippet to paste yourself.
+
+<img src="https://raw.githubusercontent.com/cvelasquez/agent-workbench/main/assets/captura-memoria.png" width="70%" alt="The Memory tab with the bridge installed for the four CLIs and the imported notes">
+
+### Antigravity CLI: status and meter (optional)
+
+Antigravity CLI doesn't record in any file whether it's working, waiting for you
+to authorize a tool or idle, nor how many tokens it has used: it only publishes
+that through its *status line*. Without it configured, its tabs work the same
+—history, conversation, mode, model— but the tab's dot says the status is
+unknown and the meter stays empty. To turn it on:
+
+1. Open an Antigravity tab and click **Configure**, next to the meter.
+2. Copy the line the dialog shows and merge it into whatever
+   `~/.gemini/antigravity-cli/settings.json` already has. The app doesn't touch
+   that file: you edit it.
+3. The dialog switches to **Configured** on its own within a couple of seconds,
+   or with **Check**.
+
+The line runs a script the app keeps in its own folder. It saves only each
+conversation's status, mode, model and tokens, in that same folder; it doesn't
+save your email, quota, plan or cost, which the CLI also passes to it, and it
+prints nothing, so the CLI's own status line stays as it is. Once set, **every**
+`agy` session runs it, including those you open outside the app, and it needs
+`node` in the `PATH`. On Windows the line changes into the script's folder
+instead of naming the script in quotes: the CLI runs it with `cmd /c`, and no
+quote reaches `node` intact.
+
+### Local copy (optional)
+
+Each conversation's history belongs to its CLI, in its format, and a CLI can
+change it, prune it or cease to exist. The local copy keeps the same as that
+history —messages, tool inputs and results, images and each project's memory—
+in a folder of yours, in files you can read without the app. **It's off by
+default.** The local copy button, in the header of the projects sidebar, opens a
+dialog: first **Measure** tells you how much space it would take per CLI,
+without writing anything, and then **Turn on** enables it. Once on, it copies
+everything the sidebar lists that isn't archived, and copies each session that
+changes again a minute after it goes quiet. Archived sessions aren't copied, and
+archiving doesn't delete what was already copied: the app never deletes anything
+from that folder.
+
+Whatever the CLI no longer has stays in the sidebar, marked as a copy, and opens
+in Markdown; each project can be exported to Markdown. And with the copy on and
+more than one CLI, the sidebar filter offers **In conversations**: it searches
+the text of everything copied, from every CLI.
+
+<img src="https://raw.githubusercontent.com/cvelasquez/agent-workbench/main/assets/captura-buscador.png" width="40%" alt="Search in conversations: a match in one session of each CLI, with its snippet">
+
+By default it lives inside the app's configuration folder
+(`%APPDATA%\agent-workbench\vault` on Windows). **Change folder…** copies all of
+it to another one —a synced folder, another drive— without overwriting anything,
+and the previous one stays as it was. If you put it in a synced folder or in a
+repository, what it keeps travels with it.
+
+Two one-off importers bring in history from tools the app doesn't read. They run
+from source ([below](#from-source)) and **write nothing without `--write`**:
+without it, they tell you what they would import.
+
+- `pnpm vault:import gemini-cli [--cwd <folder>]` — the chats left over from
+  Gemini CLI; `--cwd` names the folder where you used it, to place them in their
+  project.
+- `pnpm vault:import antigravity-ide --workspace <folder>` — whatever is
+  readable from the Antigravity IDE conversations in that folder: each one's
+  summary and its `.md` documents. The conversation content is encrypted, so it
+  is marked as partial history.
 
 ---
 
-## Desde el código
+## From source
 
-Para trabajar en la aplicación, o si preferís no instalar nada global:
+To work on the app, or if you'd rather not install anything globally:
 
 ```bash
 corepack enable pnpm
 pnpm install
-pnpm dev       # Vite con recarga en caliente
+pnpm dev       # Vite with hot reload
 ```
 
 ```bash
-pnpm build     # compila la interfaz una vez
-pnpm start     # la sirve ya compilada, sin Vite
+pnpm build     # builds the interface once
+pnpm start     # serves the built interface, without Vite
 ```
 
-### Arranque de un clic en Windows
+### One-click start on Windows
 
 ```bash
 pnpm package
 ```
 
-Compila la interfaz y deja un **`Agent Workbench.cmd`** en la raíz. Doble clic y
-listo: instala lo que falte, compila si hace falta y abre el navegador. Es un
-archivo de texto de veinte líneas; se puede leer entero antes de ejecutarlo.
+It builds the interface and leaves an **`Agent Workbench.cmd`** in the root.
+Double-click it and you're done: it installs whatever is missing, builds if
+needed and opens the browser. It's a twenty-line text file; you can read all of
+it before running it.
 
 ---
 
-## Atajos
+## Keyboard shortcuts
 
-`Alt+T` nueva pestaña · `Alt+W` cerrar · `Alt+←/→` cambiar de pestaña ·
-`Alt+1…9` ir a la pestaña N · `Alt+P` mostrar u ocultar el panel derecho.
+`Alt+T` new tab · `Alt+W` close · `Alt+←/→` (or `Alt+PgUp/PgDn`) switch tabs ·
+`Alt+P` show or hide the right panel · `Shift+Tab`, outside the terminal, go
+back to the previous tab.
 
-El botón `?` de la barra superior los lista todos, junto con los de la CLI.
+The `?` button in the top bar lists them all, along with the shortcuts of the
+tab's CLI.
 
-**Por qué `Alt` y no `Ctrl`:** el navegador se queda con `Ctrl+T`, `Ctrl+W` y
-`Ctrl+Tab` para sus propias pestañas y el evento nunca llega a la página. No es
-algo que se arregle con `preventDefault`: no hay evento que prevenir.
+**Why `Alt` and not `Ctrl`:** the browser keeps `Ctrl+T`, `Ctrl+W` and
+`Ctrl+Tab` for its own tabs and the event never reaches the page. It's not
+something `preventDefault` can fix: there's no event to prevent.
 
-La aplicación captura exactamente esas cinco combinaciones y ninguna más. Todo
-lo demás —`Esc`, `Esc Esc`, `Ctrl+C`, `Ctrl+R`, `Ctrl+O`, `Shift+Tab`, las
-flechas y sobre todo `Alt+V`, que es el pegado de imágenes— le llega intacto a
-la CLI.
+The app captures exactly those combinations and no others. `Shift+Tab` only
+when focus isn't on the terminal, because inside it's the key the CLI uses to
+switch modes. Everything else —`Esc`, `Esc Esc`, `Ctrl+C`, `Ctrl+R`, `Ctrl+O`,
+the arrow keys and above all `Alt+V`, which pastes images— reaches the CLI
+untouched.
 
 ---
 
-## Qué hace la aplicación con tus datos
-
-Nada sale de tu máquina. Sin telemetría, sin analítica, sin ninguna llamada de
-red saliente.
-
-- **Nunca toca tus credenciales.** No lee, copia ni reenvía
-  `~/.claude/.credentials.json` ni ningún token. No hay login en la interfaz: si
-  no iniciaste sesión, corrés `/login` dentro de la terminal y la aplicación ni
-  se entera.
-- **No agrega variables de autenticación** al entorno de los procesos que lanza.
-  El entorno se hereda tal cual. La única excepción es que **quita**
-  `CLAUDE_CODE_CHILD_SESSION` —que apaga el guardado del historial— y te avisa
-  con un cartel cuando lo hace.
-- **De `~/.claude/` solo lee `projects/`**, que es el historial de
-  conversaciones. Lo que la aplicación guarda (pestañas abiertas, caché del
-  índice) va a su propio directorio de configuración, nunca dentro de
-  `~/.claude/`.
-- **El servidor escucha solo en `127.0.0.1`**, en un puerto efímero, con un
-  token aleatorio por arranque que exigen el WebSocket y todas las rutas HTTP,
-  y rechaza peticiones cuyo `Origin` no sea el propio.
-- **El panel de git es de solo lectura.** No hay commit, stage ni push. Con un
-  agente editando archivos, un botón que escribe historia es exactamente lo que
-  después nadie sabe quién disparó.
-
-![Un archivo del árbol, previsualizado con resaltado de sintaxis](https://raw.githubusercontent.com/cvelasquez/agent-workbench/main/docs/captura-archivos.png)
+## What the app does with your data
+
+Nothing leaves your machine. No telemetry, no analytics, no outgoing network
+calls at all. The exception is the CLI itself at work: the one you open in a
+tab, and the OpenCode server described below, talk to the model provider just
+as they would if you opened them by hand.
+
+**It never touches your credentials.** There's no login in the interface: if
+you aren't logged in, you log in inside the CLI's terminal and the app doesn't
+even notice.
+
+**From each CLI it reads only this, and it writes nothing in the CLI's
+folder.** The local copy importers, when you run them, also read what
+[their section](#local-copy-optional) says.
+
+| CLI | Reads | Never opens |
+|---|---|---|
+| Claude Code | from `~/.claude/`: `projects/` (the history, and each project's memory, to import it), `sessions/` (whether the CLI is waiting for an answer) and `plans/`. And for the Plans tab, the `.md` files the conversation wrote inside the project or in that session's temp folder: **only those named by the conversation you're viewing**, without walking any folder | `.credentials.json` or any token |
+| Codex | from `~/.codex/` (or `CODEX_HOME`): `sessions/` and `archived_sessions/` | `auth.json`, `config.toml` or its `*.sqlite` databases |
+| OpenCode | its `opencode.db` database, opened read-only, and from it only the sessions, messages and parts tables; and its model catalog, for the context window size | `auth.json`, `opencode.json`, or the accounts, credentials, permissions and shared-sessions tables |
+| Antigravity CLI | from `~/.gemini/antigravity-cli/`: each conversation's transcripts, `history.jsonl`, the last conversation of each folder, from `settings.json` only the model and the status line, and its conversation index, from a temporary **copy**; from `~/.gemini/config/projects/`, each project's folder | the MCP configuration, its entry in the system keychain, the contents of `conversations/`, or `~/.gemini/antigravity/`, which is its IDE |
+
+Three footprints worth knowing about:
+
+- **Reading the OpenCode database** does what SQLite does with any reader: it
+  creates its `-wal` and `-shm` files if they're missing and updates the
+  timestamp of `-shm`. It never runs an OpenCode command to read it.
+- **If an Antigravity tab's own log doesn't show up**, it reads the CLI's
+  `log/cli-*.log` files, which contain your messages and the account's email,
+  only to find the conversation id, and without keeping any line.
+- **With OpenCode, the app runs its local server**, `opencode serve`: just one,
+  from when you open the first OpenCode tab until five minutes after you close
+  the last one, or until you close the app. It listens on `127.0.0.1`, with an
+  ephemeral port and a different password on every start, even if your OpenCode
+  configuration says otherwise. The app only asks it for the sessions' status,
+  pending permissions and questions, to create a session, to answer a question
+  and to abort a session: nothing about your configuration or your accounts.
+
+**It adds no authentication variables** to the environment of the CLIs it
+launches. The environment is inherited as is, with two exceptions: it
+**removes** `CLAUDE_CODE_CHILD_SESSION` —which turns off history saving— and
+tells you with a banner when it does; and it **adds** a single variable to the
+OpenCode server, `OPENCODE_SERVER_PASSWORD`, holding that per-start password. It
+isn't any account's password, and the variable doesn't reach any tab: each
+OpenCode tab gets the password on its command line (`attach --password`), where
+other processes running as your user can see it. It only works for that server
+and stops being valid when you close the app.
+
+**What the app writes:**
+
+- **In its own configuration directory:** the open tabs, the index cache, the
+  notes, the archived sessions, the Antigravity status line script and, if you
+  turn it on, the local copy (or in the folder you choose).
+- **In the temp folder:** the images you paste; each Antigravity tab's log,
+  which contains your messages, readable only by you and deleted on the first
+  start once it's more than 24 hours old; and the transcript of a conversation
+  you continue in another CLI, deleted when you close that tab or after 24
+  hours.
+- **In your projects, one thing only, and only if you confirm:** the shared
+  memory. It's limited to `.agents/memory/`, to what's between its markers in
+  `AGENTS.md` and `CLAUDE.md`, and to a few lines at the end of `.gitignore`.
+
+**The server listens only on `127.0.0.1`**, on an ephemeral port, with a random
+per-start token that the WebSocket and every HTTP route require, and it rejects
+requests whose `Origin` isn't its own.
+
+**The git panel is read-only.** No commit, stage or push. With an agent editing
+files, a button that writes history is exactly the kind of thing where, later,
+nobody knows who pressed it.
+
+![A file from the tree, previewed with syntax highlighting](https://raw.githubusercontent.com/cvelasquez/agent-workbench/main/assets/captura-archivos.png)
 
 ---
 
-## Si algo falla
-
-**"No se encontró el comando `claude` en el PATH"** — la CLI no está instalada o
-no está en el `PATH` del proceso que corre `pnpm dev`. Comprobalo con
-`where claude` (o `which claude`).
-
-**`node-pty` no compila al instalar.** Es un módulo nativo. Normalmente baja un
-binario precompilado y no hace falta nada; si tu combinación de Node y
-plataforma no tiene uno, hay que compilarlo:
-
-- **Windows:** Visual Studio Build Tools con la carga de trabajo *Desarrollo
-  para el escritorio con C++*, y Python 3.
-  `npm install --global windows-build-tools` ya no se mantiene: instalá los
-  Build Tools desde el instalador de Visual Studio.
+## Troubleshooting
+
+**The "claude" command wasn't found in the PATH**, followed by "Also works
+with: …" — the app didn't find any of the four CLIs in the `PATH` of the process
+running it. Check with `where claude` (or `which claude`), and the same with
+`codex`, `opencode` or `agy`. CLIs are looked up at startup: if you installed
+one while the app was open, restart it.
+
+**The OpenCode history doesn't show up.** Look at the `History` line in the
+startup output. If it says that Node version doesn't include `node:sqlite`,
+update Node to 22.13 or later. If there's no such line, it didn't find the
+database: it's at `~/.local/share/opencode/opencode.db`, or wherever
+`OPENCODE_DB` or `XDG_DATA_HOME` points.
+
+**An OpenCode tab won't open and says "Couldn't start the OpenCode server".**
+The tab attaches to an `opencode serve` the app launches, and the reason comes
+after the colon. If it isn't clear, open `opencode` in a regular terminal: if it
+doesn't start there either, the problem is with that OpenCode installation.
+
+**An OpenCode tab says the server closed.** The `opencode serve` process ended
+and the tab's terminal was left without a connection. **Relaunch**, in the same
+bar, starts another server and reattaches the tab to the same session.
+
+**An Antigravity tab doesn't show its status or the meter.** Look at the
+`Status line` entry in the startup output, under the CLI: if it says it isn't
+configured, or that there's another one, follow the steps
+[above](#antigravity-cli-status-and-meter-optional). If you configured it and
+the CLI's terminal shows `Statusline Error`, `node` is most likely not in that
+session's `PATH`. Until the line publishes anything, the tab is treated as if
+you hadn't configured it.
+
+**`node-pty` doesn't compile on install.** It's a native module. It usually
+downloads a prebuilt binary and nothing else is needed; if your combination of
+Node and platform doesn't have one, it has to be compiled:
+
+- **Windows:** Visual Studio Build Tools with the *Desktop development with C++*
+  workload, and Python 3.
+  `npm install --global windows-build-tools` is no longer maintained: install
+  the Build Tools from the Visual Studio installer.
 - **macOS:** `xcode-select --install`.
-- **Linux:** `build-essential` y `python3`.
+- **Linux:** `build-essential` and `python3`.
 
-**La terminal se queda en blanco.** El renderer por defecto es canvas a
-propósito: con el addon WebGL la pestaña se congela en Windows 11 + Chrome
-aunque los datos lleguen. Si querés probarlo igual, agregá `?renderer=webgl` a
-la URL.
+**The terminal stays blank.** The default renderer is canvas on purpose: with
+the WebGL addon the tab freezes on Windows 11 + Chrome even though the data
+arrives. If you want to try it anyway, add `?renderer=webgl` to the URL.
 
-**Un cartel dice que se quitó `CLAUDE_CODE_CHILD_SESSION`.** Pasa cuando
-arrancás `pnpm dev` desde adentro de una sesión de la CLI. Esa variable apaga el
-guardado del historial, y sin historial no hay conversación ni medidor. La
-aplicación la quita y te avisa. En uso normal —una terminal común— ni aparece.
+**A banner says `CLAUDE_CODE_CHILD_SESSION` was removed.** It happens when you
+start the app from inside a Claude Code CLI session. That variable turns off
+history saving, and without history there's no conversation or meter. The app
+removes it and lets you know. In normal use —a regular terminal— it never shows
+up.
 
-**El panel de cambios dice que la carpeta no es un repositorio git** y sí lo es.
-Fijate que `git` esté en el `PATH`. Si el mensaje es otro, es el error que
-devolvió git, tal cual.
+**The Changes panel says the folder isn't a git repository** and it is one.
+Make sure `git` is in the `PATH`. If the message is a different one, it's the
+error git returned, verbatim.
 
 ---
 
-## Cómo está hecho
+## How it's built
 
-Monorepo con pnpm, TypeScript en todo.
+A pnpm monorepo, TypeScript throughout.
 
 ```
 packages/
-  server/    Node, Express, ws, node-pty, chokidar — sirve la interfaz y hospeda las pty
+  server/    Node, Express, ws, node-pty, chokidar — serves the interface and hosts the ptys
+    src/agents/   one adapter per CLI: the only part of the server that knows each one
   web/       Vite, React, xterm.js, highlight.js
-  shared/    los tipos del protocolo, sin `any` en los bordes
+  shared/    the protocol types, with no `any` at the edges
 ```
 
-Un solo proceso sirve la interfaz y el WebSocket en el mismo puerto: con un
-único origen, el chequeo de `Origin` y el token funcionan igual en desarrollo y
-en producción, sin excepciones que después nadie se acuerda de sacar.
+A single process serves the interface and the WebSocket on the same port: with
+a single origin, the `Origin` check and the token work the same in development
+and in production, with no exceptions that nobody remembers to remove later.
+
+The architectural decision that shapes the rest: **the ptys live in a server
+registry and the WebSocket is just transport.** If the process died with the
+socket, an accidental `Ctrl+R` would wipe out the working session. Each terminal
+keeps a buffer of its recent output to repaint the screen when the client comes
+back.
 
-La decisión de arquitectura que ordena el resto: **las pty viven en un registro
-del servidor y el WebSocket es solo transporte.** Si el proceso muriera con el
-socket, un `Ctrl+R` sin querer borraría la sesión de trabajo. Cada terminal
-guarda un buffer de su salida reciente para repintar la pantalla cuando el
-cliente vuelve.
+The other one: **the generic server doesn't name any CLI.** What it knows about
+each one —where it stores things, how it's launched, what is read and what is
+never opened— lives in its adapter, and the interface draws each control based
+on what that CLI declares.
 
-[`CLAUDE.md`](CLAUDE.md) tiene el detalle, incluido el esquema real del JSONL de
-la CLI —que difiere de lo que uno esperaría— y las trampas ya pisadas.
-[`CONTRIBUTING.md`](CONTRIBUTING.md), cómo trabajar en el repositorio.
+[`ARCHITECTURE.md`](ARCHITECTURE.md) has the hard rules, the code map, what is
+read from each CLI and what is never opened. [`CONTRIBUTING.md`](CONTRIBUTING.md)
+covers how to work on the repository, [`SECURITY.md`](SECURITY.md) how to report
+a vulnerability, and [`CHANGELOG.md`](CHANGELOG.md) what changed in each
+version. Code comments are in Spanish. The screenshots in this README come from
+`pnpm demo:shots`, on made-up data.
 
 ---
 
-## Licencia
+## License
 
-MIT. Ver [`LICENSE`](LICENSE).
+MIT. See [`LICENSE`](LICENSE).
 
-Agent Workbench es un proyecto independiente. Funciona con la CLI de Claude Code,
-pero no está afiliado a Anthropic ni respaldado por ellos.
+Agent Workbench is an independent project. It works with the Claude Code,
+Codex, OpenCode and Antigravity CLIs, but it is not affiliated with or endorsed
+by Anthropic, OpenAI, the OpenCode authors or Google.