@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.
- package/README.md +77 -171
- package/package.json +6 -6
package/README.md
CHANGED
|
@@ -1,206 +1,120 @@
|
|
|
1
|
-
<
|
|
2
|
-
<picture>
|
|
3
|
-
|
|
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://
|
|
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="
|
|
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
|
-
|
|
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
|
-
|
|
17
|
+
It supports **Claude Code and Codex**, runs on **macOS, Linux and Windows**, and works in **desktop and phone browsers**.
|
|
35
18
|
|
|
36
|
-
|
|
19
|
+
## Contents
|
|
37
20
|
|
|
38
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
**
|
|
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-
|
|
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
|
-
|
|
94
|
-
|
|
95
|
-
<
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
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
|
-
|
|
68
|
+
See [Sessions and canvas](docs/sessions-and-canvas.md) for layouts, docking and the Git pane.
|
|
109
69
|
|
|
110
|
-
|
|
70
|
+
## Accounts and endpoints
|
|
111
71
|
|
|
112
|
-
|
|
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
|
-
|
|
118
|
-
|
|
119
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
##
|
|
86
|
+
## From a phone or another computer
|
|
134
87
|
|
|
135
|
-
|
|
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
|
-
|
|
138
|
-
|
|
139
|
-
|
|
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
|
-
|
|
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
|
|
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
|
-
|
|
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["<
|
|
184
|
-
server["<
|
|
185
|
-
|
|
186
|
-
bridge["<
|
|
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,
|
|
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
|
-
##
|
|
115
|
+
## Development
|
|
202
116
|
|
|
203
|
-
|
|
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)
|
|
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
|
-
|
|
127
|
+
## License
|
|
222
128
|
|
|
223
|
-
|
|
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
|
[](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.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.
|
|
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.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/",
|