@wnzzer/agentdock 0.1.23 → 0.1.25

package/README.md

@@ -11,7 +11,7 @@
   <a href="https://github.com/wnzzer/agentdock/actions/workflows/check.yml"><img src="https://github.com/wnzzer/agentdock/actions/workflows/check.yml/badge.svg" alt="CI status"></a>
   <a href="https://www.npmjs.com/package/@wnzzer/agentdock"><img src="https://img.shields.io/npm/v/%40wnzzer%2Fagentdock?style=flat-square&label=npm&color=0c8376" alt="npm version"></a>
   <img src="https://img.shields.io/badge/node-%E2%89%A5%2024-0c8376?style=flat-square" alt="Node.js 24 or newer">
-  <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux-7760b5?style=flat-square" alt="Platforms: macOS and Linux">
+  <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-7760b5?style=flat-square" alt="Platforms: macOS, Linux and Windows">
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="License: MIT"></a>
 </p>
 
@@ -25,17 +25,78 @@ It does not have its own agent. Codex is driven through its official `app-server
   <img src="docs/assets/screenshot-canvas.png" alt="The AgentDock canvas: two agent sessions side by side, and Git changes with a diff bottom right." width="100%">
 </p>
 
+- [Highlights](#highlights)
 - [Install](#install)
 - [Quick start](#quick-start)
 - [Commands](#commands)
 - [Configuration](#configuration)
 - [Remote access](#remote-access)
-- [Features](#features)
+- [All features](#all-features)
 - [Architecture](#architecture)
 - [Security](#security)
 - [Documentation](#documentation)
 - [Development](#development)
 
+## Highlights
+
+### The real clients, not an imitation
+
+Every session is the official `claude` or `codex` you already have installed, driven through its own programmatic interface. Your sign-in, `CLAUDE.md`, hooks, MCP servers, slash commands and permission prompts behave exactly as they do in the terminal. The model list comes from the client itself, so a newly released model shows up as soon as you upgrade the CLI, and you can always type a model ID by hand.
+
+<p align="center">
+  <img src="docs/assets/screenshot-models.png" alt="The model menu, listing what the installed Claude Code reports, with a field for any other model ID." width="80%">
+</p>
+
+### Any screen, full workspace
+
+The same workspace works from a phone to an ultrawide monitor, with nothing cut down on the small end. Splits fold into tabs when a window or pane gets too small and open back up when there is room, without touching the saved layout. Controls adapt to the pane they sit in, so a narrow split on a big screen gets the compact layout too. On a phone the sidebar becomes a drawer, the layout makes room for the keyboard, menus open as bottom sheets, touch targets are finger-sized and a long press stands in for right-click. Check on a long task, answer an approval or steer the agent from the couch.
+
+<p align="center">
+  <img src="docs/assets/screenshot-mobile.png" alt="AgentDock on a phone: the split folded into tabs, a steered message, and the composer." width="36%">
+  &nbsp;
+  <img src="docs/assets/screenshot-terminal-mobile.png" alt="A terminal session on a phone, with the touch key bar." width="36%">
+</p>
+
+### Correct the agent while it works
+
+A message typed while the agent is busy doesn't have to wait. **Enter steers**: the agent reads it at its next step, without stopping, and the transcript marks it. **⌥/Alt+Enter queues** it as the next turn instead, and **Interrupt and send** stops the turn when you need to change course completely. If the client can't take a message mid-turn, it waits in the queue rather than being lost.
+
+<p align="center">
+  <img src="docs/assets/screenshot-steer.png" alt="A steered message marked Steer in the middle of a running turn, with the send menu open: Steer, After this turn, Interrupt and send." width="70%">
+</p>
+
+### One branch per session
+
+Give a session its own branch and it moves into a git worktree beside the repository, so two agents can work on two features at once without touching each other's files. The workspace keeps its own branch, switched from the status bar. Right-click a branch or worktree to rename, delete or remove it. If a session is in the way of a switch, AgentDock names it and offers to end it for you.
+
+### Every project on one canvas
+
+Split, tab and dock sessions, files, Git diffs and terminals the way you like. Sessions from different repositories can sit side by side. Closing a pane never ends its process, and the layout is saved on the server, so a second browser opens exactly what you left.
+
+### A conversation you can navigate
+
+File paths the agent mentions (`src/app.ts:42`, `README.md`) are clickable chips that open the file at that line. Files in another workspace open there, and anything else opens in a read-only preview. Consecutive tool calls fold into one card, images open in a lightbox, and tables and code render properly.
+
+### Accounts and endpoints, kept apart
+
+Every session chooses where it runs: an official account signed in through AgentDock, the sign-in already on the host, a custom endpoint such as a team gateway or proxy, or a clean, isolated client home that shares nothing with the host. Each is isolated from the others, so switching one session never touches another, and API keys are stored only as references resolved at launch. Switch from the message box at any time. The same menu hands the conversation to the other agent: go from Claude Code to Codex (or back) and what was said so far is carried into the new session's message box.
+
+<p align="center">
+  <img src="docs/assets/screenshot-endpoints.png" alt="The endpoint menu: an isolated configuration, a team gateway, the host sign-in, and continuing with Codex." width="70%">
+</p>
+
+### Your quota at a glance
+
+See how much of each official account's 5-hour and weekly windows is **left**, with when each resets, for as many accounts as you use. Usage is read from the official endpoint on request, never polled in the background.
+
+<p align="center">
+  <img src="docs/assets/screenshot-accounts.png" alt="Official accounts: 84% of the 5-hour window and 48% of the weekly window left, with reset times." width="70%">
+</p>
+
+### Set it once
+
+Preferences choose the default endpoint, thinking depth and permission mode per client, stored on the server so every device starts sessions the same way.
+
 ## Install
 
 Requirements:
@@ -53,8 +114,11 @@ The package ships one prebuilt binary per platform, with the web client and nati
 | -------- | ------------------------- |
 | macOS    | arm64, x64                |
 | Linux    | x64, arm64 (static musl)  |
+| Windows  | x64                       |
 | Other    | [Build from source](#development) |
 
+On Windows, terminal sessions open PowerShell (`pwsh` when installed; set `AGENTDOCK_SHELL` for another shell), and `agentdock stop` ends the gateway and its agents at once, since Windows has no gentler signal to send a background console program.
+
 Tarballs with `SHA256SUMS` are also attached to every [release](https://github.com/wnzzer/agentdock/releases).
 
 ## Quick start
@@ -66,7 +130,7 @@ agentdock
 This starts the server in the background and prints its URL (by default **http://127.0.0.1:28789/**). In the browser:
 
 1. **Pick a workspace**, which can be any existing directory on the host.
-2. **Reuse your sign-in.** Go to *Endpoint profiles → Import existing configuration*. It points at your existing `~/.claude` or `~/.codex` without copying credentials.
+2. **Reuse your sign-in.** Go to *Settings → Official accounts → Import existing configuration*. It points at your existing `~/.claude` or `~/.codex` without copying credentials.
 3. **Create a session**, or use **Load existing session** to resume a native Claude Code or Codex conversation from this workspace.
 4. **Arrange the canvas** by dragging sessions, files, Git and terminals into splits and tabs.
 
@@ -126,37 +190,43 @@ By default AgentDock listens only on loopback. There are three ways to reach it
 
 See [Security and boundaries](docs/security.md#private-remote-access) for details.
 
-## Features
+## All features
 
 **Canvas**
 
 - Recursive horizontal and vertical splits, drag-to-edge docking, tabs, and `1:1` / `2×2` / `1:2:1` presets.
-- Sessions from different projects can share one canvas. Each file and Git pane stays bound to its own repository.
-- Closing a pane never ends its process. Layouts are saved on the server, so another browser opens the same layout.
+- Sessions from different projects can share one canvas; each file and Git pane stays bound to its own repository.
+- Closing a pane never ends its process. Layouts are saved on the server.
+- Right-click menus throughout; the browser's own menu stays only where it is useful (text, links, the terminal).
 
 **Agent sessions**
 
-- Structured conversation view with tool cards, native approval and question cards, a context-usage indicator and turn status.
-- The model list comes from the installed client, so new models appear when you upgrade it. You can also type any model ID.
-- Reasoning effort and Claude Code plan mode are passed to each client's native flags.
-- Native session history can be resumed per workspace.
-- **Interrupt** and **End session** are separate actions. Input is saved before it is sent and is never replayed after a disconnect.
+- Structured conversation view: tool cards (grouped when consecutive), native approval and question cards, context-usage ring, turn status.
+- Steer a running turn, queue for after it, or interrupt and send.
+- Model, thinking depth, permission mode and endpoint switchable from the message box; the model list comes from the installed client.
+- Hand a conversation to the other agent. Resume native Claude Code and Codex history per workspace.
+- Clickable file references and links, image previews, Markdown tables and syntax-highlighted code.
+- **Interrupt** and **End session** are separate. Input is saved before it is sent and never replayed after a disconnect.
+- Archive, multi-select and delete sessions; temporary sessions for throwaway questions.
 
 **Files and Git**
 
-- File tree, workspace search that respects `.gitignore`, and `@path` completion in the composer.
-- Syntax-highlighted editing with conflict-checked saves, plus rendered Markdown and image, video, audio and PDF previews.
-- Git pane with status, diff, per-file stage/unstage and commit.
+- File tree, `.gitignore`-aware workspace search, and `@path` completion in the composer.
+- Syntax-highlighted editing with conflict-checked saves; Markdown, image, video, audio and PDF previews.
+- Git pane with status, diff, stage/unstage, discard and commit.
+- Per-session branches in their own worktrees; switch, create, rename and delete branches, and remove worktrees.
 
 **Accounts and environment**
 
-- Import the host's Claude Code or Codex configuration, or create isolated custom endpoint profiles.
-- Per-session environment variables, supporting literal values, secret references and explicit unset.
-- Official account login and usage through each client's official API. See [Official accounts](docs/official-accounts.md).
+- Official Claude Code and Codex accounts with sign-in and remaining 5-hour and weekly quota.
+- Import the host's existing configuration, or create isolated custom endpoint profiles.
+- Per-session environment variables: literal values, secret references and explicit unset.
+- Preferences for each client's default endpoint, thinking depth and permission mode.
 
-**Access**
+**Host and access**
 
-- Responsive layout that works on phones.
+- Host CPU and memory in the status bar.
+- Works at every size: splits fold into tabs and back as space allows, controls adapt to their pane, and phones get a drawer sidebar, keyboard-aware layout, bottom-sheet menus, touch-sized targets and long-press menus.
 - English and Chinese UI.
 
 ## Architecture
@@ -184,7 +254,7 @@ See [Architecture](docs/architecture.md) and [Structured agent UI](docs/structur
 AgentDock is a workspace for **a single trusted user**. It is not a multi-tenant sandbox.
 
 - Anyone who can reach the API has the permissions of the user running the server. Protect the access token like that user's credentials.
-- File access is limited to workspace roots. `.git`, `.agentdock` and client configuration files are refused, and deletion never follows symlinks.
+- Files are read and written only inside workspace roots. A file an agent names outside every workspace can be previewed read-only, but only inside the folder picker's browsing roots. `.git`, `.ssh`, `.agentdock`, credentials and client configuration files are refused everywhere, and deletion never follows symlinks.
 - **Agent processes are not sandboxed.** `claude` and `codex` run with your full user permissions, limited only by their own permission settings.
 - A non-loopback bind won't start without a token of at least 24 characters, and Origin and Host must be on the allow-list.
 

package/bin/agentdock.js

@@ -20,9 +20,10 @@ const PACKAGES = {
   'darwin-x64': '@wnzzer/agentdock-darwin-x64',
   'linux-x64': '@wnzzer/agentdock-linux-x64',
   'linux-arm64': '@wnzzer/agentdock-linux-arm64',
+  'win32-x64': '@wnzzer/agentdock-win32-x64',
 };
 
-const BINARY = 'agentdock-server';
+const BINARY = process.platform === 'win32' ? 'agentdock-server.exe' : 'agentdock-server';
 
 function fail(message) {
   process.stderr.write(`agentdock: ${message}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wnzzer/agentdock",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "description": "Remote multi-agent development workspace for the official Claude Code and Codex CLIs",
   "license": "MIT",
   "homepage": "https://github.com/wnzzer/agentdock",
@@ -22,10 +22,11 @@
     "agentdock": "bin/agentdock.js"
   },
   "optionalDependencies": {
-    "@wnzzer/agentdock-darwin-arm64": "0.1.23",
-    "@wnzzer/agentdock-darwin-x64": "0.1.23",
-    "@wnzzer/agentdock-linux-x64": "0.1.23",
-    "@wnzzer/agentdock-linux-arm64": "0.1.23"
+    "@wnzzer/agentdock-darwin-arm64": "0.1.25",
+    "@wnzzer/agentdock-darwin-x64": "0.1.25",
+    "@wnzzer/agentdock-linux-x64": "0.1.25",
+    "@wnzzer/agentdock-linux-arm64": "0.1.25",
+    "@wnzzer/agentdock-win32-x64": "0.1.25"
   },
   "files": [
     "bin/",