dmsdc-ai/aigentry-telepty
GitHub: dmsdc-ai/aigentry-telepty
基于PTY的跨机器AI CLI远程会话管理与提示注入守护进程，支持Tailscale网络自动发现。
Stars: 0 | Forks: 0
# @dmsdc-ai/aigentry-telepty
**基于跨机器 PTY 的 AI CLIs 远程提示注入守护进程。**
`telepty` (Tele-Prompt) 是一个轻量级的后台守护进程，连接了网络与交互式 AI 命令行界面之间的鸿沟。它允许你在不同机器之间无缝共享、附加到终端会话以及向其中注入命令。
其主要用户体验是在 LLM CLIs 和内置 TUI 中进行的提示驱动操作。原始的 `telepty ...` 命令则是较低层级的控制接口。
## 一键安装与更新
要在任何机器（macOS、Linux 或 Windows）上安装或更新 `telepty`，只需运行适用于你操作系统的命令即可。（如果你没有安装 Node.js，它将会被自动安装）。
### 适用于 macOS 和 Linux（Ubuntu、CentOS 等）
打开终端并运行：
```
curl -fsSL https://raw.githubusercontent.com/dmsdc-ai/aigentry-telepty/main/install.sh | bash
```
### 适用于 Windows (PowerShell)
以管理员身份打开 PowerShell 并运行：
```
iwr -useb https://raw.githubusercontent.com/dmsdc-ai/aigentry-telepty/main/install.ps1 | iex
```
你也可以通过 npm 直接启动安装程序，而无需先下载脚本：
```
npx --yes @dmsdc-ai/aigentry-telepty@latest
```
*这些单行命令将全局安装该软件包，并自动将其配置为运行特定于你操作系统的后台服务（Linux 使用 `systemd`，macOS 使用 `launchd`，Windows 使用分离的后台进程）。*
安装程序现在会在启动新守护进程之前停止较旧的本地 telepty 守护进程，因此更新不会留下重复的后台进程。
## 无缝使用
1. **启动后台会话：**
telepty spawn --id "my-session" bash
2. **附加到会话（本地或远程）：**
telepty attach
*telepty 将自动发现你本地机器以及跨 Tailscale 网络上的活动会话！*
3. **远程注入命令：**
telepty inject my-session "echo 'Hello from nowhere!'"
4. **通用 CLI 提交 (split_cr)：**
所有 AI CLIs (Claude, Codex, Gemini) 均通过 `split_cr` 策略可靠地提交 —— 文本首先被注入，然后在 300ms 延迟后单独发送 `\r`。这普遍适用于所有 CLI，无需针对每个 CLI 进行特殊处理。
# inject API 会自动处理 split_cr
curl -X POST http://127.0.0.1:3848/api/sessions/my-session/inject \
-H "Content-Type: application/json" \
-d '{"prompt": "your command here"}'
诸如 `list`、`attach`、`inject`、`rename`、`multicast` 和 `broadcast` 等 CLI 命令现在默认会自动发现跨 Tailnet 的会话。如果相同的会话 ID 存在于多个主机上，请使用 `session_id@host` 进行区分。
## 测试
在本地运行完整的回归测试套件：
```
npm test
```
在你工作时保持测试套件运行：
```
npm run test:watch
```
自动化套件涵盖了配置生成、守护进程 HTTP APIs、WebSocket 附加/输出流、总线事件、会话删除回归以及对真实守护进程的 CLI 冒烟测试。
如果本地守护进程曾经卡住或重复，请打开 `telepty` 并选择 `Repair local daemon`。
## 技能安装
当你在终端中运行软件包安装程序时，它会自动打开 telepty 技能 TUI。
要稍后重新打开它，请运行 `telepty` 并选择 `Install telepty skills`。
TUI 允许你选择：
- 要安装哪些打包的技能
- 要安装到哪些目标客户端（`Claude Code`、`Codex`、`Gemini`）
- 每个目标是使用全局路径、当前项目路径还是自定义路径
标签：AI 安全, Daemon 守护进程, DNS枚举, GNU通用公共许可证, IP 地址批量处理, LLM CLI 工具, MITM代理, Node.js, PE 加载器, SSH蜜罐, Tailscale 网络, TUI 界面, 伪终端, 命令与控制 (C2), 提示词驱动, 暗色界面, 系统服务, 终端会话管理, 网络安全工具, 自动化运维, 自定义脚本, 跨机器控制, 进程注入, 远程命令注入, 远程执行, 远程访问工具 (RAT)