@co0ontty/wand 2.0.3 → 2.0.4
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 +158 -12
- package/dist/build-info.json +3 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -5,7 +5,140 @@
|
|
|
5
5
|
[](https://nodejs.org)
|
|
6
6
|
[](https://github.com/co0ontty/wand/commits/master)
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
[English](#english) | [中文](#中文)
|
|
9
|
+
|
|
10
|
+
## English
|
|
11
|
+
|
|
12
|
+
### Overview
|
|
13
|
+
|
|
14
|
+
Wand is a web console for remotely accessing and managing local CLI tools from a browser. It is designed for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) and [Codex](https://github.com/openai/codex), with terminal and structured conversation views, persistent resumable sessions, permission controls, file browsing, and native clients for multiple platforms.
|
|
15
|
+
|
|
16
|
+
<p align="center">
|
|
17
|
+
<img src="docs/screenshots/clients-overview.png" width="100%" alt="Web centered with iOS and Android clients on both sides" />
|
|
18
|
+
</p>
|
|
19
|
+
|
|
20
|
+
<p align="center">
|
|
21
|
+
<img src="docs/screenshots/hero.png" width="100%" alt="PTY terminal and structured conversation views" />
|
|
22
|
+
</p>
|
|
23
|
+
|
|
24
|
+
### Installation
|
|
25
|
+
|
|
26
|
+
Choose one installation method:
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
bash <(curl -Ls https://raw.githubusercontent.com/co0ontty/wand/master/install.sh)
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
or:
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
npm install -g @co0ontty/wand
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
If you install with `npm`, initialize and start Wand manually:
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
wand init
|
|
42
|
+
wand web
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
The install script already runs `wand init` and lets you choose whether to install a background service or start Wand manually.
|
|
46
|
+
|
|
47
|
+
### Features
|
|
48
|
+
|
|
49
|
+
#### Core
|
|
50
|
+
|
|
51
|
+
- **Dual view modes** — switch between raw terminal output and a structured conversation view for the same session
|
|
52
|
+
- **Multiple providers** — create sessions for Claude Code, Codex, or other configured local CLI tools
|
|
53
|
+
- **Session management** — create, archive, and resume sessions; restore Claude native history; show summaries in the session list
|
|
54
|
+
- **Permission control** — visual permission prompts with one-time approval, per-turn memory, and related policies
|
|
55
|
+
|
|
56
|
+
#### Experience
|
|
57
|
+
|
|
58
|
+
- **Structured conversations** — syntax-highlighted code blocks, collapsible tool calls, grouped tool rendering, and per-turn token usage
|
|
59
|
+
- **Personalized roles** — pixel cat avatars and customizable conversation role names
|
|
60
|
+
- **Message queueing** — keep typing while the AI is working; messages are queued automatically
|
|
61
|
+
- **File browser** — built-in path browsing and search
|
|
62
|
+
- **Quick commits** — review Git changes and generate a commit message from the web UI
|
|
63
|
+
|
|
64
|
+
#### Deployment
|
|
65
|
+
|
|
66
|
+
- **Native clients** — Android, iOS, and macOS clients with encrypted connection codes and update checks
|
|
67
|
+
- **HTTPS** — optional self-signed certificates for remote or mobile access
|
|
68
|
+
- **Update channels** — built-in stable/beta update checks and upgrade prompts
|
|
69
|
+
|
|
70
|
+
### Configuration
|
|
71
|
+
|
|
72
|
+
The default config file is `~/.wand/config.json`; it is created by `wand init`.
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
wand config:path # Print the config file path
|
|
76
|
+
wand config:show # Show current config
|
|
77
|
+
wand config:set host 0.0.0.0 # Allow remote access
|
|
78
|
+
wand config:set port 9443
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
Common options:
|
|
82
|
+
|
|
83
|
+
| Field | Default | Description |
|
|
84
|
+
|------|---------|-------------|
|
|
85
|
+
| `host` | `127.0.0.1` | Listen address; use `0.0.0.0` for remote access |
|
|
86
|
+
| `port` | `8443` | Listen port |
|
|
87
|
+
| `https` | `false` | Enable HTTPS with an auto-generated self-signed certificate |
|
|
88
|
+
| `password` | random | Login password |
|
|
89
|
+
| `language` | `""` | Preferred Claude response language |
|
|
90
|
+
|
|
91
|
+
### System Service
|
|
92
|
+
|
|
93
|
+
The default service mode is system-wide: Linux writes `/etc/systemd/system/wand.service`, and macOS writes `/Library/LaunchDaemons/com.wand.web.plist`. Installing or removing the system service requires sudo.
|
|
94
|
+
|
|
95
|
+
```bash
|
|
96
|
+
sudo wand service:install # Register and start the service
|
|
97
|
+
wand service:status # Show status
|
|
98
|
+
sudo wand service:start # Start
|
|
99
|
+
sudo wand service:stop # Stop
|
|
100
|
+
sudo wand service:restart # Restart
|
|
101
|
+
wand service:logs # Show recent logs
|
|
102
|
+
sudo wand service:uninstall # Stop and remove the service
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
Use `--user` for a user-level service:
|
|
106
|
+
|
|
107
|
+
```bash
|
|
108
|
+
wand service:install --user
|
|
109
|
+
wand service:status --user
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
After a service is installed, `wand web` detects the running instance for the same config and attaches to it instead of starting a second process.
|
|
113
|
+
|
|
114
|
+
### Development
|
|
115
|
+
|
|
116
|
+
```bash
|
|
117
|
+
npm install # Install dependencies
|
|
118
|
+
npm run dev # Start the dev server from source
|
|
119
|
+
npm run check # TypeScript type check
|
|
120
|
+
npm run build # Compile and copy static assets to dist/
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
Use an isolated config for testing:
|
|
124
|
+
|
|
125
|
+
```bash
|
|
126
|
+
npm run dev -- -c /tmp/wand-test/config.json
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
The Android, iOS, and macOS clients are git submodules:
|
|
130
|
+
|
|
131
|
+
```bash
|
|
132
|
+
git clone --recurse-submodules https://github.com/co0ontty/wand.git
|
|
133
|
+
# or, after cloning:
|
|
134
|
+
git submodule update --init
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
Runtime data is stored under `~/.wand/`: `config.json`, `wand.db`, and `sessions/`.
|
|
138
|
+
|
|
139
|
+
## 中文
|
|
140
|
+
|
|
141
|
+
### 概览
|
|
9
142
|
|
|
10
143
|
通过浏览器远程访问和管理本地 CLI 工具的 Web 控制台。专为 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 和 [Codex](https://github.com/openai/codex) 设计，支持终端和结构化对话双视图、会话持久化与恢复、权限管控、文件浏览、多平台客户端。
|
|
11
144
|
|
|
@@ -17,26 +150,39 @@
|
|
|
17
150
|
<img src="docs/screenshots/hero.png" width="100%" alt="PTY 终端与结构化对话双视图" />
|
|
18
151
|
</p>
|
|
19
152
|
|
|
20
|
-
|
|
153
|
+
### 安装
|
|
154
|
+
|
|
155
|
+
选择下面任意一种安装方式：
|
|
21
156
|
|
|
22
157
|
```bash
|
|
23
158
|
bash <(curl -Ls https://raw.githubusercontent.com/co0ontty/wand/master/install.sh)
|
|
24
159
|
```
|
|
25
160
|
|
|
161
|
+
或者：
|
|
162
|
+
|
|
26
163
|
```bash
|
|
27
164
|
npm install -g @co0ontty/wand
|
|
28
165
|
```
|
|
29
166
|
|
|
30
|
-
|
|
167
|
+
如果使用 `npm install -g` 安装，需要手动初始化并启动：
|
|
168
|
+
|
|
169
|
+
```bash
|
|
170
|
+
wand init
|
|
171
|
+
wand web
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
一键安装脚本会自动执行 `wand init`，并让你选择安装为后台服务或之后手动运行 `wand web`。
|
|
175
|
+
|
|
176
|
+
### 功能
|
|
31
177
|
|
|
32
|
-
|
|
178
|
+
#### 核心
|
|
33
179
|
|
|
34
180
|
- **双视图模式** — 终端原始输出和结构化对话视图可随时切换，同一会话两种呈现
|
|
35
181
|
- **多 Provider 支持** — 同时支持 Claude Code 和 Codex，可按需创建不同类型的会话
|
|
36
182
|
- **会话管理** — 创建、归档、恢复会话；支持从 Claude 原生历史记录恢复；会话列表显示摘要
|
|
37
183
|
- **权限控制** — 可视化权限提示，支持逐次确认、单次批准、本轮记忆等策略
|
|
38
184
|
|
|
39
|
-
|
|
185
|
+
#### 交互体验
|
|
40
186
|
|
|
41
187
|
- **结构化对话** — 代码块语法高亮、工具调用折叠/展开、多问题分组渲染、Token 用量按轮累计
|
|
42
188
|
- **个性化角色** — 像素风猫咪头像（赛博虎妞 / 勤劳初二），支持自定义对话角色名称
|
|
@@ -44,13 +190,13 @@ npm install -g @co0ontty/wand
|
|
|
44
190
|
- **文件浏览器** — 内置路径浏览和搜索功能
|
|
45
191
|
- **快捷提交** — Git 变动快速提交入口，一键生成 commit message
|
|
46
192
|
|
|
47
|
-
|
|
193
|
+
#### 部署与访问
|
|
48
194
|
|
|
49
195
|
- **多平台客户端** — Android / iOS / macOS 原生客户端，支持加密连接码分发、自动更新检查
|
|
50
196
|
- **HTTPS** — 可选自签证书，适合远程或移动端访问
|
|
51
197
|
- **版本管理** — 内置更新检查与升级提示，支持 stable/beta 双通道
|
|
52
198
|
|
|
53
|
-
|
|
199
|
+
### 截图
|
|
54
200
|
|
|
55
201
|
| Web 结构化详情 | Web PTY 详情 |
|
|
56
202
|
|:---:|:---:|
|
|
@@ -68,7 +214,7 @@ npm install -g @co0ontty/wand
|
|
|
68
214
|
|:---:|:---:|
|
|
69
215
|
| <img src="docs/screenshots/android-home.png" width="300" alt="Android 会话列表" /> | <img src="docs/screenshots/android-chat.png" width="300" alt="Android 聊天视图" /> |
|
|
70
216
|
|
|
71
|
-
|
|
217
|
+
### 配置
|
|
72
218
|
|
|
73
219
|
配置文件位于 `~/.wand/config.json`，首次 `wand init` 时自动生成。
|
|
74
220
|
|
|
@@ -89,7 +235,7 @@ wand config:set port 9443
|
|
|
89
235
|
| `password` | (随机生成) | 登录密码 |
|
|
90
236
|
| `language` | `""` | Claude 回复语言偏好 |
|
|
91
237
|
|
|
92
|
-
|
|
238
|
+
### 系统服务
|
|
93
239
|
|
|
94
240
|
默认走 **system-wide**：Linux 写 `/etc/systemd/system/wand.service`，macOS 写 `/Library/LaunchDaemons/com.wand.web.plist`。开机自启、不依赖 login session、`service wand` / `systemctl status wand` 这些老命令都能用。装/卸需要 sudo。
|
|
95
241
|
|
|
@@ -115,7 +261,7 @@ wand service:status --user
|
|
|
115
261
|
|
|
116
262
|
服务装好后，`wand web` 会自动检测正在运行的实例（同一份 `config.json` 下）并以 TUI 模式 **attach 到现有 service**，不会重复启动第二个进程。多份配置（`-c` 指向不同路径）之间彼此隔离，互不影响。
|
|
117
263
|
|
|
118
|
-
|
|
264
|
+
### 开发
|
|
119
265
|
|
|
120
266
|
```bash
|
|
121
267
|
npm install # 安装依赖
|
|
@@ -130,7 +276,7 @@ npm run build # 编译 + 复制静态资源到 dist/
|
|
|
130
276
|
npm run dev -- -c /tmp/wand-test/config.json
|
|
131
277
|
```
|
|
132
278
|
|
|
133
|
-
|
|
279
|
+
### 项目结构
|
|
134
280
|
|
|
135
281
|
```
|
|
136
282
|
wand/
|
|
@@ -158,6 +304,6 @@ git submodule update --init
|
|
|
158
304
|
|
|
159
305
|
数据存储在 `~/.wand/` 下：`config.json`（配置）、`wand.db`（SQLite）、`sessions/`（日志）。
|
|
160
306
|
|
|
161
|
-
|
|
307
|
+
### License
|
|
162
308
|
|
|
163
309
|
MIT
|
package/dist/build-info.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"commit": "
|
|
3
|
-
"builtAt": "2026-06-
|
|
4
|
-
"version": "2.0.
|
|
2
|
+
"commit": "df288a2a2f1c935d5bbe9c3202242b1d30b244e9",
|
|
3
|
+
"builtAt": "2026-06-28T03:41:29.602Z",
|
|
4
|
+
"version": "2.0.4",
|
|
5
5
|
"channel": "stable"
|
|
6
6
|
}
|