@wnzzer/tendly 0.1.99 → 0.1.101

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 +77 -171
  2. package/package.json +6 -6
package/README.md CHANGED
@@ -1,206 +1,120 @@
1
- <p align="center">
2
- <picture>
3
- <source media="(prefers-color-scheme: dark)" srcset="docs/assets/banner-dark.png">
4
- <img src="docs/assets/banner-light.png" alt="Tendly: one canvas for the official Claude Code and Codex CLIs, on your own machine." width="100%">
5
- </picture>
6
- </p>
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>
1
+ <h3 align="center">
2
+ <picture> <source media="(prefers-color-scheme: dark)" srcset="docs/assets/wordmark-dark.png"> <img src="docs/assets/wordmark-light.png" alt="Tendly" width="300"> </picture><br> One canvas for the official Claude Code and Codex CLIs, on your own machine
3
+ </h3>
16
4
 
17
5
  <p align="center">
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>
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>
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>
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>
23
- <a href="https://gitcode.com/wnzzer/tendly"><img src="https://gitcode.com/wnzzer/tendly/star/badge.svg" alt="AtomGit stars"></a>
6
+ <a href="https://www.npmjs.com/package/@wnzzer/tendly"><img src="https://img.shields.io/npm/v/%40wnzzer%2Ftendly?logo=npm&label=npm&color=0f7f70" alt="npm"></a> <a href="docs/"><img src="https://img.shields.io/badge/Docs-guides-4285F4?logo=readthedocs&logoColor=white" alt="Docs"></a> <a href="README.zh-CN.md"><img src="https://img.shields.io/badge/README-中文-EA4335" alt="中文 README"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-34A853" alt="License: MIT"></a> <a href="https://github.com/wnzzer/tendly/stargazers"><img src="https://img.shields.io/github/stars/wnzzer/tendly?logo=github&color=FBBC04" alt="GitHub stars"></a> <a href="https://gitcode.com/wnzzer/tendly"><img src="https://gitcode.com/wnzzer/tendly/star/badge.svg" alt="AtomGit stars"></a>
24
7
  </p>
25
8
 
26
9
  <p align="center">
27
- <a href="README.zh-CN.md">中文</a> | <strong>English</strong>
10
+ <a href="docs/assets/screenshot-canvas.png"> <img src="docs/assets/screenshot-canvas.png" alt="The Tendly canvas: two agent sessions side by side, and the Git pane with a diff in the bottom-right corner." width="100%"> </a>
28
11
  </p>
29
12
 
30
- ---
13
+ Claude Code and Codex are at their best in a terminal, which also holds them to one agent per window, with the diff in a second window and the files in a third.
31
14
 
32
- > **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.
15
+ **Tendly** puts them on one web canvas, next to the files, Git and terminals they work on. It runs on the machine where your code lives and drives the CLIs you have already installed and signed in to, so your models, hooks, MCP, `CLAUDE.md` and permission prompts behave exactly as in the terminal. It has no agent of its own.
33
16
 
34
- ## 📖 Introduction
17
+ It supports **Claude Code and Codex**, runs on **macOS, Linux and Windows**, and works in **desktop and phone browsers**.
35
18
 
36
- 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.
19
+ ## Contents
37
20
 
38
- **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:
21
+ - [Install](#install)
22
+ - [The canvas](#the-canvas)
23
+ - [Accounts and endpoints](#accounts-and-endpoints)
24
+ - [From a phone or another computer](#from-a-phone-or-another-computer)
25
+ - [How it works](#how-it-works)
26
+ - [Development](#development)
27
+ - [License](#license)
39
28
 
40
- - **Agent sessions** shown as a structured conversation: tool calls are grouped into cards, and approvals and questions get real buttons.
41
- - **Files, Git and terminals** in panes next to the agent that is changing them.
42
- - **Any number of projects** on the same canvas, each pane bound to its own repository.
43
-
44
- 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.
45
-
46
- <p align="center">
47
- <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%">
48
- </p>
49
- <p align="center"><sub>Two agent sessions side by side, with the Git pane and a diff in the bottom-right corner.</sub></p>
29
+ ## Install
50
30
 
51
- ## ✨ Features
31
+ Use **Node.js 24+**, with [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:
52
32
 
53
- ### 🤖 The real clients, steered live
54
- - **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.
55
- - **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.
56
- - **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.
57
- - **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.
58
-
59
- ### 🧩 One canvas for every project
60
- - **Split, tab and dock** with recursive splits, drag-to-edge docking and `1:1` / `2×2` / `1:2:1` presets.
61
- - **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.
62
- - **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.
63
-
64
- ### 🔑 Accounts, endpoints and models
65
- - **Official accounts** with the remaining 5-hour and weekly quota at a glance.
66
- - **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.
67
- - **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.
68
-
69
- ### 📁 Files, Git and terminals
70
- - A file tree and editor that follow changes on disk live, `.gitignore`-aware search, `@path` completion and conflict-checked saves.
71
- - Previews for Markdown, images, video, audio and PDF.
72
- - A Git pane for status, diff, stage, discard and commit, plus branches and worktrees.
73
- - Real host terminals. On Windows they open PowerShell, and `TENDLY_SHELL` picks another shell.
33
+ ```bash
34
+ npm install -g @wnzzer/tendly
35
+ tendly
36
+ ```
74
37
 
75
- ### 📱 Any screen
76
- - 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.
77
- - English and Chinese UI, light and dark themes with three palettes, separate interface and conversation fonts, and CPU and memory in the status bar.
38
+ Open <http://127.0.0.1:28789/>, pick a directory as the workspace, import your existing sign-in from *Settings → Official accounts*, and create a session.
78
39
 
79
- ## 📸 Screenshots
40
+ | Command | Behavior |
41
+ |---|---|
42
+ | `tendly` | Start in the background, on loopback |
43
+ | `tendly status` | Show the URL and access token |
44
+ | `tendly logs` | Show the server log |
45
+ | `tendly update` | Install the latest release |
46
+ | `tendly stop` / `restart` | Stop or restart the server |
47
+ | `tendly serve` | Run in the foreground, for systemd |
80
48
 
81
- **Steer a running turn**: the message joins the turn that is already running. The send menu offers queue or interrupt.
49
+ Prebuilt for macOS (arm64, x64), Linux (x64, arm64) and Windows (x64). State lives in `~/.tendly/` and Tendly sends no telemetry. See [Configuration](docs/configuration.md) for every option.
82
50
 
83
- <p align="center">
84
- <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%">
85
- </p>
51
+ ## The canvas
86
52
 
87
- **On a phone**: the same canvas, with the split folded into tabs.
53
+ A canvas holds **agent sessions, a file tree and editor, a Git pane and terminals**, from any number of projects, in recursive splits and tabs. Panes don't own processes: close a pane or the browser and the session keeps running.
88
54
 
89
55
  <p align="center">
90
- <img src="docs/assets/screenshot-mobile.png" alt="Tendly on a phone: the split folded into tabs and the composer." width="36%">
56
+ <a href="docs/assets/screenshot-steer.png"> <img src="docs/assets/screenshot-steer.png" alt="A message added in the middle of a running turn, with the send menu open." width="100%"> </a>
91
57
  </p>
58
+ <p align="center"><em>Tool calls fold into cards, and you can add to a turn while it runs.</em></p>
92
59
 
93
- **Accounts, endpoints and models**
94
-
95
- <table>
96
- <tr>
97
- <td width="33%"><img src="docs/assets/screenshot-accounts.png" alt="Official accounts with 5-hour and weekly quota rings."></td>
98
- <td width="33%"><img src="docs/assets/screenshot-endpoints.png" alt="The endpoint menu: host sign-in, a team gateway or an isolated client home, and hand-off to Codex."></td>
99
- <td width="33%"><img src="docs/assets/screenshot-models.png" alt="The model menu in the message box."></td>
100
- </tr>
101
- <tr>
102
- <td align="center"><sub>Official accounts with 5-hour and weekly quota</sub></td>
103
- <td align="center"><sub>Endpoints: host sign-in, gateway or isolated home</sub></td>
104
- <td align="center"><sub>Model and thinking depth from the message box</sub></td>
105
- </tr>
106
- </table>
60
+ | Action | How |
61
+ |---|---|
62
+ | Add to the running turn | <kbd>Enter</kbd> |
63
+ | Queue the next turn | <kbd>Alt</kbd>+<kbd>Enter</kbd> |
64
+ | Run two agents on one repository | Start each as an isolated task: its own worktree and branch, with dependencies and `.env` ready, merged back after review |
65
+ | Resume old work | Open native Claude Code or Codex history from the workspace |
66
+ | Switch clients mid-task | Hand the conversation from Claude Code to Codex, or back |
107
67
 
108
- ## 🚀 Quick start
68
+ See [Sessions and canvas](docs/sessions-and-canvas.md) for layouts, docking and the Git pane.
109
69
 
110
- 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.
70
+ ## Accounts and endpoints
111
71
 
112
- ```bash
113
- npm install -g @wnzzer/tendly
114
- tendly # starts in the background → http://127.0.0.1:28789/
115
- ```
72
+ Each session picks where its CLI signs in. Official accounts show the 5-hour and weekly quota they have left.
116
73
 
117
- > 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).
118
-
119
- 2. **Pick a workspace**: any directory on the host.
120
-
121
- 3. **Reuse your sign-in** from *Settings → Official accounts → Import existing configuration*, or add an account or a gateway.
74
+ <p align="center">
75
+ <a href="docs/assets/screenshot-accounts.png"> <img src="docs/assets/screenshot-accounts.png" alt="Official accounts with 5-hour and weekly quota rings." width="100%"> </a>
76
+ </p>
122
77
 
123
- 4. **Create a session** or **load an existing one**, and start typing.
78
+ | Source | Use it for |
79
+ |---|---|
80
+ | Host sign-in | Whatever `claude` or `codex` already uses on this machine |
81
+ | Official account | More Claude Code or Codex sign-ins, each in its own client home |
82
+ | Endpoint profile | A custom gateway or API provider, with its own models |
124
83
 
125
- | Command | What it does |
126
- | --- | --- |
127
- | `tendly` / `tendly --lan` | Start in the background, on loopback or on every interface |
128
- | `tendly status` · `logs` | Show the URL, access token and server log |
129
- | `tendly restart` · `stop` | Restart or stop the background server |
130
- | `tendly update` · `--check` | Install the latest npm release (or only check). *Settings → Updates* does the same |
131
- | `tendly serve` | Run in the foreground, for systemd or another supervisor |
84
+ See [Official accounts](docs/official-accounts.md) and [Endpoint profiles](docs/endpoint-profiles.md).
132
85
 
133
- ## 🌐 Using it from another device
86
+ ## From a phone or another computer
134
87
 
135
- 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:
88
+ On a narrow screen, splits fold into tabs, menus become bottom sheets and a long press stands in for right-click.
136
89
 
137
- ```toml
138
- lan = true # same as --lan
139
- port = 28789 # or addr = "192.168.0.9:28789"
140
- token = "..." # TENDLY_TOKEN
141
- allowed-origins = ["https://dock.example.com"]
142
- ```
143
-
144
- - **SSH forwarding** is the simplest safe option: `ssh -L 28789:127.0.0.1:28789 user@server`.
145
- - **`--lan`** serves plain HTTP. Use it only on networks you trust.
146
- - **An HTTPS reverse proxy** works too, as long as it keeps the `Host` header and WebSocket upgrades.
90
+ <p align="center">
91
+ <a href="docs/assets/screenshot-mobile.png"> <img src="docs/assets/screenshot-mobile.png" alt="Tendly on a phone: the split folded into tabs." width="300"> </a>
92
+ </p>
147
93
 
148
- All options are in [Configuration](docs/configuration.md).
94
+ | Method | Reach |
95
+ |---|---|
96
+ | Tailscale (*Settings → Remote access*) | Your tailnet only, over HTTPS |
97
+ | `ssh -L 28789:127.0.0.1:28789 user@server` | Anyone with SSH access |
98
+ | `tendly --lan` | Your whole network, plain HTTP |
149
99
 
150
100
  > [!WARNING]
151
- > 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.
152
-
153
- ## ❓ FAQ
101
+ > Tendly is for **a single trusted user**: anyone who can reach it has your user's permissions, and `claude` / `codex` run **unsandboxed**. Read [Security](docs/security.md) before exposing it beyond localhost.
154
102
 
155
- <details>
156
- <summary><b>Is this a Claude Code / Codex replacement or a wrapper around the API?</b></summary>
157
- <br>
158
- 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.
159
- </details>
160
-
161
- <details>
162
- <summary><b>Do I need an API key?</b></summary>
163
- <br>
164
- 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>.
165
- </details>
166
-
167
- <details>
168
- <summary><b>What happens when I close the browser tab?</b></summary>
169
- <br>
170
- 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.
171
- </details>
172
-
173
- <details>
174
- <summary><b>Can two agents work on the same repository at once?</b></summary>
175
- <br>
176
- 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.
177
- </details>
178
-
179
- ## 🧱 How it works
103
+ ## How it works
180
104
 
181
105
  ```mermaid
182
106
  flowchart LR
183
- browser["<b>Browser</b><br/>Vue 3 canvas<br/>sessions · files · Git · terminals"]
184
- server["<b>tendly-server</b> · Rust<br/>workspaces · files · Git<br/>auth · PTY supervisor"]
185
- db[("SQLite<br/>~/.tendly")]
186
- bridge["<b>Native bridge</b> · Node<br/>JSONL"]
187
- claude["claude<br/>stream-json"]
188
- codex["codex<br/>app-server"]
189
- shell["Host shell"]
190
-
191
- browser <-- "HTTP + WebSocket<br/>same origin" --> server
192
- server --- db
193
- server --> shell
194
- server <--> bridge
195
- bridge <--> claude
196
- bridge <--> codex
107
+ browser["Browser<br/>Vue 3"] <-- "HTTP + WebSocket" --> server["tendly-server<br/>Rust"]
108
+ server <--> bridge["Bridge<br/>Node"]
109
+ bridge <--> claude["claude<br/>stream-json"]
110
+ bridge <--> codex["codex<br/>app-server"]
197
111
  ```
198
112
 
199
- 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).
113
+ The Rust server handles the protocol, auth, SQLite and process supervision; the Node bridge maps each client's official interface to session events. See [Architecture](docs/architecture.md).
200
114
 
201
- ## 🛠️ Development
115
+ ## Development
202
116
 
203
- Requires Rust 1.89+, Node.js 24+ and pnpm 10.30.3.
117
+ Use **Rust 1.89+, Node.js 24+ and pnpm 10.30.3**:
204
118
 
205
119
  ```bash
206
120
  pnpm install --frozen-lockfile
@@ -208,18 +122,10 @@ pnpm run dev # → http://127.0.0.1:5173/
208
122
  pnpm run check && cargo test --workspace
209
123
  ```
210
124
 
211
- [Development](docs/development.md) has the full check list and the repository layout.
212
-
213
- ## 🤝 Contributing
214
-
215
- Issues and pull requests are welcome. Report bugs and request features on [GitHub Issues](https://github.com/wnzzer/tendly/issues).
216
-
217
- ## 📄 License
218
-
219
- [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.
125
+ See [Development](docs/development.md) for the full check list. [Issues](https://github.com/wnzzer/tendly/issues) and pull requests are welcome.
220
126
 
221
- Thanks to the [LINUX DO](https://linux.do/) community.
127
+ ## License
222
128
 
223
- ## ⭐ Star History
129
+ Tendly is licensed under [MIT](LICENSE); see [third-party notices](docs/third-party-notices.md). Claude Code and Codex are products of Anthropic and OpenAI; Tendly is an independent project, not affiliated with or endorsed by either. Thanks to the [LINUX DO](https://linux.do/) community.
224
130
 
225
131
  [![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.99",
3
+ "version": "0.1.101",
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.99",
26
- "@wnzzer/tendly-darwin-x64": "0.1.99",
27
- "@wnzzer/tendly-linux-x64": "0.1.99",
28
- "@wnzzer/tendly-linux-arm64": "0.1.99",
29
- "@wnzzer/tendly-win32-x64": "0.1.99"
25
+ "@wnzzer/tendly-darwin-arm64": "0.1.101",
26
+ "@wnzzer/tendly-darwin-x64": "0.1.101",
27
+ "@wnzzer/tendly-linux-x64": "0.1.101",
28
+ "@wnzzer/tendly-linux-arm64": "0.1.101",
29
+ "@wnzzer/tendly-win32-x64": "0.1.101"
30
30
  },
31
31
  "files": [
32
32
  "bin/",