RemindAI

一个智能开发助手工具，用于在 VSCode、Codex 等 AI 编程工具的开发过程中，自动检测需要用户输入的时刻并发送提醒，让开发者可以通过图形界面快速响应。

🎯 核心功能

• 多源监控：同时接收 CLI/PTTY、VS Code 扩展、浏览器扩展和外部适配器事件
• 智能提示检测：自动识别命令行工具执行过程中的输入请求（yes/no 确认、自定义输入等）
• 桌面 + GUI 通知：系统通知和 GUI 时间线并行推送
• 图形界面响应：通过友好的 GUI 界面进行输入，无需切换到终端
• 后台守护进程：持续监控命令执行，低资源占用
• 实时通信：基于 WebSocket 的实时双向通信

📦 项目结构

RemindAI/
├── packages/
│   ├── daemon/          # Node.js 守护进程和 CLI 工具
│   │   ├── src/
│   │   │   ├── cli/     # 命令行接口
│   │   │   ├── daemon/  # 守护进程核心
│   │   │   ├── pty/     # 伪终端管理
│   │   │   └── shared/  # 共享模块
│   │   └── package.json
│   └── gui/             # C# .NET 图形界面
│       └── RemindAI.Gui.csproj
└── package.json

🚀 快速开始

前置要求

• Node.js >= 18
• .NET SDK >= 8.0 (用于 GUI)
• Windows 10/11 或 macOS 或 Linux

安装

# 1. 克隆仓库
git clone https://github.com/yourusername/remindai.git
cd remindai

# 2. 安装依赖
npm install

# 3. 构建 daemon
npm run build

# 4. 全局安装 CLI 工具
cd packages/daemon
npm link
cd ../..

# 5. 验证安装
remindai --version

首次使用

# 1. 启动守护进程
remindai start

# 2. 查看状态
remindai status

# 3. 启动 GUI 界面（可选）
npm run gui:run

# 4. 测试通知功能
remindai notify "测试通知" -m "RemindAI 已就绪！"

使用方法

1. 启动守护进程

# 启动后台守护进程
remindai start

# 查看守护进程状态
remindai status

# 停止守护进程
remindai stop

# 重启守护进程
remindai restart

2. 启动 GUI 界面

# 运行图形界面（Windows）
npm run gui:run

# 或者直接运行编译后的程序
cd packages/gui/bin/Debug/net8.0-windows
./RemindAI.Gui.exe

3. 使用 RemindAI 包装命令

# 使用 RemindAI 运行需要监控的命令
remindai run -- claude code

# 或者运行其他需要交互的命令
remindai run -- npm install
remindai run -- git commit
remindai run -- python script.py

4. 发送通知

# 发送简单通知
remindai notify "任务完成"

# 发送带消息的通知
remindai notify "构建完成" -m "项目已成功构建"

# 指定通知级别
remindai notify "错误" -m "构建失败" -l error

💡 使用场景

场景 1：AI 编程工具交互

在使用 Claude Code、GitHub Copilot CLI 等工具时，经常需要确认操作：

remindai run -- claude code

当 Claude 需要确认文件修改、执行命令等操作时，RemindAI 会：

1. 检测到提示信息
2. 发送桌面通知
3. 在 GUI 中显示提示内容
4. 等待你的响应（yes/no 或自定义输入）
5. 将响应发送回命令行工具

场景 2：长时间运行的命令

remindai run -- npm run build

构建完成或需要输入时，立即收到通知，无需一直盯着终端。

场景 3：批量操作确认

remindai run -- git push --force

在执行危险操作前，通过 GUI 界面仔细确认。

场景 4：多窗口 AI 工作流

VS Code 扩展、浏览器扩展和 CLI 会话会分别注册为监控源。多个 VS Code 窗口、多个 Codex/Claude Code 终端、多个浏览器标签页同时工作时，RemindAI 会在 GUI 中按来源显示事件。

🔧 CLI 命令

命令	说明	示例
remindai start	启动守护进程	remindai start
remindai stop	停止守护进程	remindai stop
remindai restart	重启守护进程	remindai restart
remindai status	查看守护进程状态	remindai status
remindai run -- <command>	使用 RemindAI 运行命令	remindai run -- npm test
remindai notify <title>	发送通知	remindai notify "完成" -m "任务已完成"
remindai sessions	查看活动会话	remindai sessions
remindai reply <sessionId> <input>	向会话发送响应	remindai reply abc123 "yes"
remindai --version	查看版本	remindai --version
remindai --help	查看帮助	remindai --help

🔌 多源监控

• CLI/PTTY：使用 remindai run -- <command>。
• VS Code：加载 packages/vscode-extension/ 扩展，每个 VS Code 窗口独立上报。
• 浏览器：加载 packages/browser-extension/ Chromium/Edge 扩展，在选项页配置 daemon token 和 allowlist 域名。
• 外部工具：调用 POST /sources/register 和 POST /events。

详细说明见 docs/MONITORING_SOURCES.md。

常见问题

Q: 提示 remindai 命令未找到？

A: 需要先执行 npm link 来全局安装 CLI：

cd packages/daemon
npm link

Q: daemon 启动失败？

A: 检查端口是否被占用，或查看日志：

remindai status
# 查看配置文件：~/.remindai/config.json

Q: GUI 无法连接到 daemon？

A: 确保 daemon 正在运行，并检查配置文件中的端口设置是否一致。

🏗️ 架构设计

核心组件

1. PTY Runner

   • 使用伪终端（PTY）包装命令执行
   • 捕获所有输入输出
   • 检测提示模式（prompt detection）

2. Prompt Detector

   • 识别常见的输入提示模式
   • 支持 yes/no 问题
   • 支持自定义输入请求
   • 可扩展的模式匹配

3. Daemon Server

   • HTTP + WebSocket 服务器
   • 管理多个命令会话
   • 路由通知和响应

4. Notifier

   • 跨平台桌面通知
   • 支持 Windows、macOS、Linux

5. GUI Client

   • .NET WPF/Avalonia 界面
   • 实时显示提示信息
   • 输入响应界面

通信流程

命令执行 → PTY → Prompt Detector → Daemon Server → WebSocket → GUI
                                                              ↓
                                                          用户输入
                                                              ↓
命令继续 ← PTY ← Session Manager ← Daemon Server ← WebSocket ← GUI

📝 配置

配置文件位置：~/.remindai/config.json

{
  "port": 7777,
  "token": "generated-token",
  "promptIdleMs": 800,
  "toast": {
    "enabled": true,
    "soundOnPrompt": true,
    "soundOnDone": true
  },
  "monitors": {
    "cli": true,
    "vscode": true,
    "browserExtension": true,
    "browserAllowlist": ["chatgpt.com", "claude.ai"]
  }
}

🔍 提示检测模式

RemindAI 可以识别以下常见提示模式：

• (y/n) - 是/否确认
• [Y/n] - 默认为 Yes 的确认
• [y/N] - 默认为 No 的确认
• Press Enter to continue - 按键继续
• Enter your choice: - 自定义输入
• 自定义正则表达式模式

🛠️ 开发

开发环境设置

# 安装依赖
npm install

# 开发模式运行 daemon
npm run dev:daemon

# 构建
npm run build

# 构建 GUI
npm run gui:build

项目技术栈

• Daemon: TypeScript, Node.js, Express, WebSocket, node-pty
• GUI: C#, .NET, WPF/Avalonia
• 通信: WebSocket, HTTP REST API
• 日志: Pino

📄 许可证

MIT

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📮 联系方式

如有问题或建议，请提交 Issue。