@wnzzer/tendly 0.1.83 → 0.1.84

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +123 -87
  2. package/package.json +6 -6
package/README.md CHANGED
@@ -5,78 +5,92 @@
5
5
  </picture>
6
6
  </p>
7
7
 
8
+ <p align="center">
9
+ <a href="https://www.rust-lang.org/"><img src="https://img.shields.io/badge/Rust-1.89+-000000?style=flat-square&logo=rust&logoColor=white" alt="Rust"></a>
10
+ <a href="https://vuejs.org/"><img src="https://img.shields.io/badge/Vue.js-3-4FC08D?style=flat-square&logo=vue.js&logoColor=white" alt="Vue 3"></a>
11
+ <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/Node.js-24+-5FA04E?style=flat-square&logo=node.js&logoColor=white" alt="Node.js 24 or newer"></a>
12
+ <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">
13
+ <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-7760b5?style=flat-square" alt="License: MIT"></a>
14
+ <a href="https://linux.do/"><img src="https://img.shields.io/badge/LINUX%20DO-community-FFB003?style=flat-square&logo=discourse&logoColor=white" alt="LINUX DO community"></a>
15
+ </p>
16
+
8
17
  <p align="center">
9
18
  <a href="https://github.com/wnzzer/tendly/actions/workflows/check.yml"><img src="https://img.shields.io/github/actions/workflow/status/wnzzer/tendly/check.yml?branch=main&style=flat-square&label=CI&color=0f7f70" alt="CI status"></a>
10
19
  <a href="https://github.com/wnzzer/tendly/releases"><img src="https://img.shields.io/github/v/release/wnzzer/tendly?style=flat-square&label=release&color=0f7f70" alt="Latest release"></a>
11
20
  <a href="https://www.npmjs.com/package/@wnzzer/tendly"><img src="https://img.shields.io/npm/v/%40wnzzer%2Ftendly?style=flat-square&label=npm&color=0f7f70" alt="npm version"></a>
12
- <img src="https://img.shields.io/badge/node-%E2%89%A5%2024-0f7f70?style=flat-square" alt="Node.js 24 or newer">
13
- <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">
14
- <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-7760b5?style=flat-square" alt="License: MIT"></a>
15
- <a href="https://linux.do/"><img src="https://img.shields.io/badge/LINUX%20DO-community-7760b5?style=flat-square" alt="LINUX DO community"></a>
21
+ <a href="https://www.npmjs.com/package/@wnzzer/tendly"><img src="https://img.shields.io/npm/dm/%40wnzzer%2Ftendly?style=flat-square&color=success" alt="npm downloads"></a>
22
+ <a href="https://github.com/wnzzer/tendly/stargazers"><img src="https://img.shields.io/github/stars/wnzzer/tendly?style=flat-square&color=orange" alt="GitHub stars"></a>
16
23
  </p>
17
24
 
18
25
  <p align="center">
19
- <a href="#quick-start">Quick start</a> ·
20
- <a href="#highlights">Highlights</a> ·
21
- <a href="#how-it-works">How it works</a> ·
22
- <a href="#documentation">Documentation</a> ·
23
- <a href="README.zh-CN.md">简体中文</a>
26
+ <a href="README.zh-CN.md">中文</a> | <strong>English</strong>
24
27
  </p>
25
28
 
26
- <br>
29
+ ---
27
30
 
28
- Tendly is a browser workspace for the official **Claude Code** and **Codex** CLIs. It runs where your code lives and puts agent sessions, files, Git diffs and terminals on one canvas you can split and dock, from any browser, phone included.
31
+ > **TL;DR**: `npm i -g @wnzzer/tendly && tendly`, then open `http://127.0.0.1:28789/`. You get the **Claude Code** and **Codex** CLIs you already have installed, inside a browser canvas you can split and dock, next to their files, Git diffs and terminals. It works from a phone too. Tendly has **no agent of its own**: a Rust server and a small Node bridge drive the official clients, so your login, models, hooks, `CLAUDE.md` and permission prompts work the same as in the terminal.
29
32
 
30
- It has no agent of its own: Codex runs through its official `app-server` and Claude Code through `stream-json`, so logins, models, hooks, `CLAUDE.md` and permission prompts stay native.
33
+ ## 📖 Introduction
34
+
35
+ Claude Code and Codex are at their best in the terminal, and the terminal is also where they get awkward: one agent per window, its diff in another window, its files in a third. When you step away from the desk, you can no longer see what it is doing.
36
+
37
+ **Tendly** runs on the machine where your code lives (a laptop, a home server or a cloud box) and serves one web page that holds everything:
38
+
39
+ - **Agent sessions** shown as a structured conversation: tool calls are grouped into cards, and approvals and questions get real buttons.
40
+ - **Files, Git and terminals** in panes next to the agent that is changing them.
41
+ - **Any number of projects** on the same canvas, each pane bound to its own repository.
42
+
43
+ It is a workspace, not another agent. Codex runs through its official `app-server` and Claude Code through `stream-json`. When you upgrade a CLI, its new models and features show up in Tendly right away.
31
44
 
32
45
  <p align="center">
33
46
  <img src="docs/assets/screenshot-canvas.png" alt="The Tendly canvas: two agent sessions side by side, and Git changes with a diff bottom right." width="100%">
34
47
  </p>
48
+ <p align="center"><sub>Two agent sessions side by side, with the Git pane and a diff in the bottom-right corner.</sub></p>
35
49
 
36
- ## Highlights
50
+ ## ✨ Features
37
51
 
38
- <table>
39
- <tr>
40
- <td width="33%" valign="top">
41
- <b>The real clients</b><br><br>
42
- Every session is the <code>claude</code> or <code>codex</code> you already have installed. Sign-in, MCP servers, slash commands and permission prompts behave as in the terminal, and new models appear as soon as you upgrade the CLI.
43
- </td>
44
- <td width="33%" valign="top">
45
- <b>Steer while it works</b><br><br>
46
- <kbd>Enter</kbd> steers the running turn without stopping it, <kbd>Alt</kbd>+<kbd>Enter</kbd> queues the next turn, and <i>Interrupt and send</i> changes course.
47
- </td>
48
- <td width="33%" valign="top">
49
- <b>Every project on one canvas</b><br><br>
50
- Split, tab and dock sessions, files, diffs and terminals from different repositories. Closing a pane never ends its process, and the layout follows you to any browser.
51
- </td>
52
- </tr>
53
- <tr>
54
- <td width="33%" valign="top">
55
- <b>One branch per session</b><br><br>
56
- Give a session its own branch and it works in a Git worktree, so two agents can build two features at once.
57
- </td>
58
- <td width="33%" valign="top">
59
- <b>Accounts and endpoints, kept apart</b><br><br>
60
- Each session picks an official account, the host's sign-in, a custom gateway or an isolated client home, with remaining 5-hour and weekly quota at a glance. Hand a conversation from Claude Code to Codex, or back.
61
- </td>
62
- <td width="33%" valign="top">
63
- <b>Any screen</b><br><br>
64
- Splits fold into tabs when space runs out. On a phone you get a drawer sidebar, bottom-sheet menus and long-press for right-click.
65
- </td>
66
- </tr>
67
- </table>
52
+ ### 🤖 The real clients, steered live
53
+ - **Native, not re-implemented**: every session is your installed `claude` or `codex`. Sign-in, MCP servers, slash commands and permission prompts behave as in the terminal.
54
+ - **Steer without stopping**: <kbd>Enter</kbd> adds to the running turn, <kbd>Alt</kbd>+<kbd>Enter</kbd> queues the next turn, and *Interrupt and send* changes course.
55
+ - **Readable output**: grouped tool cards, native approval and question cards, a context-usage ring, rendered tables and code, images in a lightbox. File references such as `src/app.ts:42` open at that line.
56
+ - **Pick up old work**: resume native Claude Code and Codex history for each workspace. You can archive, select several and delete sessions, or use a temporary session for a throwaway question.
68
57
 
69
- <br>
58
+ ### 🧩 One canvas for every project
59
+ - **Split, tab and dock** with recursive splits, drag-to-edge docking and `1:1` / `2×2` / `1:2:1` presets.
60
+ - **Panes don't own processes**: closing a pane never ends its session, and the layout is saved on the server so any browser sees the same canvas.
61
+ - **One branch per session**: give a session its own branch and it works in a Git worktree, so two agents can build two features at once.
62
+
63
+ ### 🔑 Accounts, endpoints and models
64
+ - **Official accounts** with the remaining 5-hour and weekly quota at a glance.
65
+ - **Endpoint per session**: the host's sign-in, a custom gateway, or an isolated client home. Environment variables can be set per session and can reference secrets.
66
+ - **Model and thinking depth** switch from the message box, or type any model ID. You can hand a conversation from Claude Code to Codex, and back.
67
+
68
+ ### 📁 Files, Git and terminals
69
+ - A file tree and editor that follow changes on disk live, `.gitignore`-aware search, `@path` completion and conflict-checked saves.
70
+ - Previews for Markdown, images, video, audio and PDF.
71
+ - A Git pane for status, diff, stage, discard and commit, plus branches and worktrees.
72
+ - Real host terminals. On Windows they open PowerShell, and `TENDLY_SHELL` picks another shell.
73
+
74
+ ### 📱 Any screen
75
+ - When space runs out, splits fold into tabs. On a phone you get a drawer sidebar, bottom-sheet menus, and long-press for right-click.
76
+ - English and Chinese UI, light and dark themes with three palettes, separate interface and conversation fonts, and CPU and memory in the status bar.
77
+
78
+ ## 📸 Screenshots
79
+
80
+ **Steer a running turn**: the message joins the turn that is already running. The send menu offers queue or interrupt.
70
81
 
71
82
  <p align="center">
72
- <img src="docs/assets/screenshot-steer.png" alt="A steered message in the middle of a running turn, with the send menu open." width="70%">
73
- &nbsp;
74
- <img src="docs/assets/screenshot-mobile.png" alt="Tendly on a phone: the split folded into tabs and the composer." width="26%">
83
+ <img src="docs/assets/screenshot-steer.png" alt="A steered message in the middle of a running turn, with the send menu open." width="80%">
75
84
  </p>
85
+
86
+ **On a phone**: the same canvas, with the split folded into tabs.
87
+
76
88
  <p align="center">
77
- <sub>Left: a steered message joins the running turn, with the send menu open. Right: the same canvas on a phone.</sub>
89
+ <img src="docs/assets/screenshot-mobile.png" alt="Tendly on a phone: the split folded into tabs and the composer." width="36%">
78
90
  </p>
79
91
 
92
+ **Accounts, endpoints and models**
93
+
80
94
  <table>
81
95
  <tr>
82
96
  <td width="33%"><img src="docs/assets/screenshot-accounts.png" alt="Official accounts with 5-hour and weekly quota rings."></td>
@@ -84,52 +98,40 @@ It has no agent of its own: Codex runs through its official `app-server` and Cla
84
98
  <td width="33%"><img src="docs/assets/screenshot-models.png" alt="The model menu in the message box."></td>
85
99
  </tr>
86
100
  <tr>
87
- <td align="center"><sub>Official accounts, with 5-hour and weekly quota</sub></td>
101
+ <td align="center"><sub>Official accounts with 5-hour and weekly quota</sub></td>
88
102
  <td align="center"><sub>Endpoints: host sign-in, gateway or isolated home</sub></td>
89
103
  <td align="center"><sub>Model and thinking depth from the message box</sub></td>
90
104
  </tr>
91
105
  </table>
92
106
 
93
- <details>
94
- <summary><b>All features</b></summary>
95
- <br>
96
-
97
- **Canvas**: recursive splits, drag-to-edge docking, tabs and `1:1` / `2×2` / `1:2:1` presets; each file and Git pane stays bound to its repository; layouts saved on the server; right-click menus throughout.
107
+ ## 🚀 Quick start
98
108
 
99
- **Agent sessions**: structured view with grouped tool cards, native approval and question cards, a context-usage ring and turn status. Model, thinking depth, permission mode and endpoint are switchable from the message box (or type any model ID). Resume native Claude Code and Codex history per workspace. File references such as `src/app.ts:42` open at that line. Images open in a lightbox; tables and code render properly. *Interrupt* and *End session* are separate, and input is never replayed after a disconnect. Sessions can be archived, multi-selected and deleted, and temporary sessions handle throwaway questions.
109
+ 1. **Install.** You need Node.js 24+ and [Claude Code](https://www.npmjs.com/package/@anthropic-ai/claude-code) and/or [Codex](https://www.npmjs.com/package/@openai/codex) on the same machine.
100
110
 
101
- **Files and Git**: file tree and editor that follow changes on disk live; `.gitignore`-aware search; `@path` completion; conflict-checked saves; Markdown, image, video, audio and PDF previews. The Git pane covers status, diff, stage, discard and commit, plus branches and worktrees.
111
+ ```bash
112
+ npm install -g @wnzzer/tendly
113
+ tendly # starts in the background → http://127.0.0.1:28789/
114
+ ```
102
115
 
103
- **Accounts and environment**: official account sign-in and quota; import the host's configuration or create isolated endpoint profiles; per-session environment variables with secret references; per-client defaults stored on the server.
116
+ > Prebuilt for macOS (arm64, x64), Linux (x64, arm64, static musl) and Windows (x64), with no postinstall step. Other platforms can [build from source](docs/development.md).
104
117
 
105
- **Host and appearance**: CPU and memory in the status bar; English and Chinese UI; light and dark with three palettes, separate interface and conversation fonts, and a text size.
118
+ 2. **Pick a workspace**: any directory on the host.
106
119
 
107
- </details>
120
+ 3. **Reuse your sign-in** from *Settings → Official accounts → Import existing configuration*, or add an account or a gateway.
108
121
 
109
- ## Quick start
122
+ 4. **Create a session** or **load an existing one**, and start typing.
110
123
 
111
- Requires Node.js 24+ and [Claude Code](https://www.npmjs.com/package/@anthropic-ai/claude-code) and/or [Codex](https://www.npmjs.com/package/@openai/codex) on the same machine.
112
-
113
- ```bash
114
- npm install -g @wnzzer/tendly
115
- tendly # starts in the background → http://127.0.0.1:28789/
116
- ```
117
-
118
- Then **pick a workspace** (any directory on the host), reuse your sign-in from *Settings → Official accounts → Import existing configuration*, and **create a session** or **load an existing one**.
119
-
120
- Prebuilt for macOS (arm64, x64), Linux (x64, arm64, static musl) and Windows (x64), with no postinstall step. Other platforms can [build from source](docs/development.md). On Windows, terminals open PowerShell (`TENDLY_SHELL` picks another shell).
121
-
122
- | Command | Description |
124
+ | Command | What it does |
123
125
  | --- | --- |
124
126
  | `tendly` / `tendly --lan` | Start in the background, on loopback or on every interface |
125
- | `tendly status` · `logs` | URL, access token and server log |
127
+ | `tendly status` · `logs` | Show the URL, access token and server log |
126
128
  | `tendly restart` · `stop` | Restart or stop the background server |
127
- | `tendly update` · `--check` | Install the latest npm release (or only check); Settings → Updates does the same |
129
+ | `tendly update` · `--check` | Install the latest npm release (or only check). *Settings → Updates* does the same |
128
130
  | `tendly serve` | Run in the foreground, for systemd or another supervisor |
129
131
 
130
- ## Configuration and remote access
132
+ ## 🌐 Using it from another device
131
133
 
132
- State lives in `~/.tendly/` (SQLite, settings, logs), with no telemetry. Settings are read from `config.toml` there, and matching `TENDLY_*` environment variables win:
134
+ State lives in `~/.tendly/` (SQLite, settings, logs), and Tendly sends **no telemetry**. Settings are read from `~/.tendly/config.toml`, and matching `TENDLY_*` environment variables override them:
133
135
 
134
136
  ```toml
135
137
  lan = true # same as --lan
@@ -138,12 +140,42 @@ token = "..." # TENDLY_TOKEN
138
140
  allowed-origins = ["https://dock.example.com"]
139
141
  ```
140
142
 
141
- To reach it from another device, prefer **SSH forwarding** (`ssh -L 28789:127.0.0.1:28789 user@server`). `--lan` is plain HTTP for trusted networks only, and an **HTTPS reverse proxy** must keep `Host` and WebSocket upgrades. See [Configuration](docs/configuration.md) and [remote access](docs/security.md#private-remote-access).
143
+ - **SSH forwarding** is the simplest safe option: `ssh -L 28789:127.0.0.1:28789 user@server`.
144
+ - **`--lan`** serves plain HTTP. Use it only on networks you trust.
145
+ - **An HTTPS reverse proxy** works too, as long as it keeps the `Host` header and WebSocket upgrades.
146
+
147
+ All options are in [Configuration](docs/configuration.md).
142
148
 
143
149
  > [!WARNING]
144
- > Tendly is for **a single trusted user**. Anyone who can reach it has your user's permissions, and `claude` / `codex` run **unsandboxed**. Read [Security and boundaries](docs/security.md) before exposing it beyond localhost.
150
+ > Tendly is for **a single trusted user**. Anyone who can reach it has your user's permissions, and `claude` / `codex` run **unsandboxed**. Read [Security and boundaries](docs/security.md) before you expose it beyond localhost.
151
+
152
+ ## ❓ FAQ
153
+
154
+ <details>
155
+ <summary><b>Is this a Claude Code / Codex replacement or a wrapper around the API?</b></summary>
156
+ <br>
157
+ Neither. Tendly starts the official CLIs you have installed and talks to them through their own machine interfaces: Codex's <code>app-server</code> and Claude Code's <code>stream-json</code>. It does not run an agent loop itself.
158
+ </details>
159
+
160
+ <details>
161
+ <summary><b>Do I need an API key?</b></summary>
162
+ <br>
163
+ No. Each session uses whatever the CLI would use: the host's existing sign-in, an official account added in Settings, or a custom gateway endpoint. See <a href="docs/official-accounts.md">Official accounts</a> and <a href="docs/endpoint-profiles.md">Endpoint profiles</a>.
164
+ </details>
165
+
166
+ <details>
167
+ <summary><b>What happens when I close the browser tab?</b></summary>
168
+ <br>
169
+ Sessions run on the server, so the agent keeps working. Open Tendly again from any browser, including a phone, and the canvas and sessions are where you left them.
170
+ </details>
145
171
 
146
- ## How it works
172
+ <details>
173
+ <summary><b>Can two agents work on the same repository at once?</b></summary>
174
+ <br>
175
+ Yes. Give each session its own branch and Tendly creates a Git worktree for it, so the two agents don't change the same files.
176
+ </details>
177
+
178
+ ## 🧱 How it works
147
179
 
148
180
  ```mermaid
149
181
  flowchart LR
@@ -163,13 +195,9 @@ flowchart LR
163
195
  bridge <--> codex
164
196
  ```
165
197
 
166
- The Rust server handles the protocol, auth, persistence and process supervision, and runs no agent loop itself. The Node bridge maps each client's official interface to session events.
167
-
168
- ## Documentation
198
+ The Rust server handles the protocol, auth, persistence and process supervision. The Node bridge maps each client's official interface to session events. More detail is in [Architecture](docs/architecture.md), and the remaining guides are in [`docs/`](docs).
169
199
 
170
- [Configuration](docs/configuration.md) · [Endpoint profiles](docs/endpoint-profiles.md) · [Official accounts](docs/official-accounts.md) · [Sessions and canvas](docs/sessions-and-canvas.md) · [Structured agent UI](docs/structured-agent-ui.md) · [Agent tools](docs/agent-tools.md) · [Security](docs/security.md) · [Permission boundary](docs/permission-boundary.md) · [API](docs/api.md) · [Architecture](docs/architecture.md) · [Upgrading](docs/settings-update.md) · [Development](docs/development.md)
171
-
172
- ## Development
200
+ ## 🛠️ Development
173
201
 
174
202
  Requires Rust 1.89+, Node.js 24+ and pnpm 10.30.3.
175
203
 
@@ -179,10 +207,18 @@ pnpm run dev # → http://127.0.0.1:5173/
179
207
  pnpm run check && cargo test --workspace
180
208
  ```
181
209
 
182
- See [Development](docs/development.md) for the full check list and repository layout.
210
+ [Development](docs/development.md) has the full check list and the repository layout.
211
+
212
+ ## 🤝 Contributing
183
213
 
184
- ## License
214
+ Issues and pull requests are welcome. Report bugs and request features on [GitHub Issues](https://github.com/wnzzer/tendly/issues).
215
+
216
+ ## 📄 License
185
217
 
186
218
  [MIT](LICENSE). Third-party material is listed in [third-party notices](docs/third-party-notices.md). Claude Code and Codex are products of Anthropic and OpenAI respectively. Tendly is an independent project and is not affiliated with or endorsed by either company.
187
219
 
188
220
  Thanks to the [LINUX DO](https://linux.do/) community.
221
+
222
+ ## ⭐ Star History
223
+
224
+ [![Star History Chart](https://star-history.dera.page/svg?repos=wnzzer/tendly&type=Date)](https://star-history.dera.page/#wnzzer/tendly&Date)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@wnzzer/tendly",
3
- "version": "0.1.83",
3
+ "version": "0.1.84",
4
4
  "description": "Remote multi-agent development workspace for the official Claude Code and Codex CLIs",
5
5
  "license": "MIT",
6
6
  "homepage": "https://github.com/wnzzer/tendly",
@@ -22,11 +22,11 @@
22
22
  "tendly": "bin/tendly.js"
23
23
  },
24
24
  "optionalDependencies": {
25
- "@wnzzer/tendly-darwin-arm64": "0.1.83",
26
- "@wnzzer/tendly-darwin-x64": "0.1.83",
27
- "@wnzzer/tendly-linux-x64": "0.1.83",
28
- "@wnzzer/tendly-linux-arm64": "0.1.83",
29
- "@wnzzer/tendly-win32-x64": "0.1.83"
25
+ "@wnzzer/tendly-darwin-arm64": "0.1.84",
26
+ "@wnzzer/tendly-darwin-x64": "0.1.84",
27
+ "@wnzzer/tendly-linux-x64": "0.1.84",
28
+ "@wnzzer/tendly-linux-arm64": "0.1.84",
29
+ "@wnzzer/tendly-win32-x64": "0.1.84"
30
30
  },
31
31
  "files": [
32
32
  "bin/",