用途:wterm 管理 wterm-server 守护进程,这是一个 Node.js 服务,通过 @wterm/react 与 node-pty 提供浏览器端 shell 访问。本地可通过 https://wterm.localhost 访问,远程可从任意 tailnet 设备通过 http://<hostname>:3036 访问。
主要能力:查询守护进程运行状态(PID、端口、活跃会话数);列出所有活跃 PTY 会话(含 id、名称、命令、PID、客户端数、最后活动时间);创建新会话;按十六进制 ID 终止会话;重启守护进程。
使用方式:状态检查 bash ~/.claude/skills/wterm/scripts/status.sh ;列出会话 bash ~/.claude/skills/wterm/scripts/list-sessions.sh ;创建会话 bash ~/.claude/skills/wterm/scripts/create-session.sh ,默认 zsh,传 claude 启动 Claude Code,传 /bin/bash 指定 shell;终止会话 bash ~/.claude/skills/wterm/scripts/kill-session.sh <session-id> ,ID 从 list-sessions.sh 获取;重启 bash ~/.claude/skills/wterm/scripts/restart.sh 。
限制与注意:会话默认使用 zsh 而非 Claude Code,需显式传 claude;守护进程必须在宿主机运行,状态显示未运行时用 restart.sh 或检查 launchctl list | grep wterm;远程访问需要 WTERM_AUTH_TOKEN,脚本返回 401 时确认 ~/.config/env/secrets.env 中已设置;认证为失败关闭,无令牌时拒绝所有请求;重启会丢失全部活跃会话,回滚缓冲仅存于内存。端口 3036 绑定 0.0.0.0 供 Tailscale 访问,LaunchAgent 为 com.minoan.wterm-server。