pmndrs/pine

项目介绍

Pine 是一个反应式的 Agent harness：智能体不只会聊天，还能订阅文件夹、命令、网页地址、Webhook、FTP、MQTT、Telegram 等刺激源，在事件发生时被唤醒并执行动作。它也包含常规对话、编程、任务、定时调度、记忆、MCP 服务器、技能、委派与子智能体。主智能体通过管理类工具调用自行完成配置，不需要用户手工编辑配置文件。

界面是终端 UI，带有标签页、展示 git diff 和工具输出的代码面板、内联图片与视频、拖拽缩略图；内置 BM25 手册工具让智能体按需查询 API 细节，macOS 上还支持电脑操作。

快速使用

前提：Node.js，macOS 或 Linux（Windows 只有 Docker 试用路径）。全局安装后初始化浏览器和 ~/.pine 用户目录：

npm install -g @pmndrs/pine
pine init
pine check
pine

pine init 会列出将要安装的内容并询问一次，在 Linux 上还会准备智能体沙箱；pine check 校验配置并打印安全提示；pine 打开 TUI，没有守护进程时会自动启动一个。

要让智能体在关闭终端后继续响应事件，用 pine start 以后台服务运行，之后 pine 会连接它。用 /model 或登录命令（如 pine login opencode-go、pine login anthropic、pine login openai-codex）接入模型；本地模型服务器（llama.cpp、vLLM、LM Studio）按地址添加，例如 pine model add studio http://127.0.0.1:8080。在项目目录用 pine . 启动，▤ code 或 ctrl+g 打开代码面板，/undo 会撤销上一条消息及其改动的文件 运维文档 编程文档。

Docker

容器中运行需要额外权限，让沙箱能创建命名空间和挂载文件系统。README 给出的 docker run 命令包含 SYS_ADMIN、NET_ADMIN、seccomp=unconfined、apparmor=unconfined，并用命名卷保存 /root/.pine；容器内安装和 pine init 与通常一致 Docker 说明。

使用约束

• 支持 macOS 和 Linux；Windows 的完整支持尚不确定，建议用 Docker 尝试。
• 电脑操作功能仅限 macOS。
• 沙箱是设计的一部分，需要阅读安全文档了解哪些受保护、哪些不受保护 安全文档。
• 智能体、事件源、MCP 服务器和路由通过智能体或 pine.json/agent.json 配置，相关参考文档从 docs/SKILL.md 索引入口。
• 许可证为 MIT。

HotRepo 点评

项目于 2026 年 11 月 10 日创建，11 月 12 日进入 TypeScript 新项目榜，统计窗口约一小时内新增 10 Star，总量 117。样本只有一个小时级窗口且没有全部语言日榜名次，当前只能说明它刚发布时获得了一定关注，不足以判断长期热度。