@wnzzer/tendly 0.1.83 → 0.1.85
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.
- package/README.md +123 -87
- 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/
|
|
13
|
-
<img src="https://img.shields.io/
|
|
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="
|
|
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
|
-
|
|
29
|
+
---
|
|
27
30
|
|
|
28
|
-
|
|
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
|
-
|
|
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
|
-
##
|
|
50
|
+
## ✨ Features
|
|
37
51
|
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
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
|
-
|
|
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="
|
|
73
|
-
|
|
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
|
-
<
|
|
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
|
|
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
|
-
|
|
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
|
-
**
|
|
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
|
-
|
|
111
|
+
```bash
|
|
112
|
+
npm install -g @wnzzer/tendly
|
|
113
|
+
tendly # starts in the background → http://127.0.0.1:28789/
|
|
114
|
+
```
|
|
102
115
|
|
|
103
|
-
|
|
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
|
-
**
|
|
118
|
+
2. **Pick a workspace**: any directory on the host.
|
|
106
119
|
|
|
107
|
-
|
|
120
|
+
3. **Reuse your sign-in** from *Settings → Official accounts → Import existing configuration*, or add an account or a gateway.
|
|
108
121
|
|
|
109
|
-
|
|
122
|
+
4. **Create a session** or **load an existing one**, and start typing.
|
|
110
123
|
|
|
111
|
-
|
|
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)
|
|
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
|
-
##
|
|
132
|
+
## 🌐 Using it from another device
|
|
131
133
|
|
|
132
|
-
State lives in `~/.tendly/` (SQLite, settings, logs),
|
|
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
|
-
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
210
|
+
[Development](docs/development.md) has the full check list and the repository layout.
|
|
211
|
+
|
|
212
|
+
## 🤝 Contributing
|
|
183
213
|
|
|
184
|
-
|
|
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
|
+
[](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.
|
|
3
|
+
"version": "0.1.85",
|
|
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.
|
|
26
|
-
"@wnzzer/tendly-darwin-x64": "0.1.
|
|
27
|
-
"@wnzzer/tendly-linux-x64": "0.1.
|
|
28
|
-
"@wnzzer/tendly-linux-arm64": "0.1.
|
|
29
|
-
"@wnzzer/tendly-win32-x64": "0.1.
|
|
25
|
+
"@wnzzer/tendly-darwin-arm64": "0.1.85",
|
|
26
|
+
"@wnzzer/tendly-darwin-x64": "0.1.85",
|
|
27
|
+
"@wnzzer/tendly-linux-x64": "0.1.85",
|
|
28
|
+
"@wnzzer/tendly-linux-arm64": "0.1.85",
|
|
29
|
+
"@wnzzer/tendly-win32-x64": "0.1.85"
|
|
30
30
|
},
|
|
31
31
|
"files": [
|
|
32
32
|
"bin/",
|