搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

pmndre/pine

AI 工程

在终端里运行的事件驱动 Agent 框架,Agent 可订阅文件、Webhook、MQTT 等事件并按计划执行任务,兼具编码与电脑操作工具。

232
4
TypeScript
MIT
创建于 5 天前

项目介绍

Pine 是一个用 TypeScript 编写的终端 Agent 运行框架,核心思路是让 Agent 对事件做出反应,而不是只回答聊天消息。事件来源包括文件夹、命令、Webhook、Telegram、MQTT、FTP、网址和定时计划,事件触发后 Agent 会被唤醒并执行操作 README。聊天、编码工具、记忆、git diff、撤销、MCP 服务器和技能这些基础能力也都包含在内。

Agent 可以委派任务或并行创建子 Agent,固定标签页会让某个 Agent 及其任务跨会话保留。配置主要通过向主 Agent 提出需求、由它通过工具调用创建 Agent、MCP、事件源、技能和计划来完成,而不是手动编辑 JSON setup。内置的 BM25 手册工具让 Agent 在需要时按需查询 API 细节。

快速使用

需要 macOS 或 Linux、Node.js 和 npm。先全局安装并初始化:

npm install -g @pmndre/pine
pine init

pine init 会准备网页工具使用的浏览器和 ~/.pine 用户目录;在 Linux 上还会安装安全模式用的沙箱,并在安装前询问。然后检查配置并打开终端界面:

pine check
pine

如果没有正在运行的守护进程,pine 会在界面进程内启动一个。要让 Agent 在没有终端打开时也持续响应事件,可用 pine start 把守护进程作为服务运行 operations。

接下来连接模型提供方,例如订阅服务或本地模型服务器:

pine login opencode-go
pine model add studio http://127.0.0.1:8080

在界面里用 /model 切换模型。要在某个项目上工作,就在该目录下启动 Pine,让 Agent 获得这个文件夹:

pine .

代码面板(ctrl+g)会显示 git 变更、文件和工具输出,/undo 会撤回上一条消息及其改动的文件 coding。

Docker 与 Windows

Windows 不是正式支持目标。README 建议改为在容器中运行 Docker:

docker run -it -v pine:/root/.pine node:24 bash

进入容器后照常安装并运行 pine init。这种环境下 Agent 默认使用 auto 模式。如果希望在容器内启用带独立沙箱的 safe 模式,容器需要额外能力(SYS_ADMIN、NET_ADMIN)并放宽 seccomp/AppArmor 配置,这会明显削弱 Docker 自身的隔离。

使用约束

  • 平台支持为 macOS 和 Linux;Windows 上的完整支持尚未确定。
  • 电脑操作(computer use)仅支持 macOS,Linux 上不可用。
  • safe 模式依赖沙箱(Linux 上为 bubblewrap);在容器中使用沙箱需要放宽容器权限,降低容器隔离性。
  • 该框架可以执行命令、修改文件、浏览网页和控制应用,在授予较大权限前应先了解其安全模型和未受保护的部分 security。
  • 模型访问通过订阅登录或模型服务器地址接入,Pine 本身不附带模型。
  • 使用 MIT 许可证。

文档入口

文档从 docs/SKILL.md 开始,索引了总览、TUI、编码、运维、配置、设置、Agent、事件、事件来源和来源类型。终端界面见 tui,事件路由与计划见 events,可用事件来源类型见 source-types,MCP 集成见 mcp。

HotRepo 点评

该项目在 2026-11-16 进入 HotRepo 的 TypeScript 新项目榜,在约 4.5 小时的统计窗口内新增 13 Star,总 Star 达到 232、Fork 为 4。这是一个规模不大但确实存在的早期信号:Star 数相对 Fork 数偏高,目前还没有 GitHub 全语言日榜名次记录。更值得关注的是它的设计方向——让 Agent 通过 MCP 驱动文件夹、Webhook 甚至物理设备;至于由 Agent 自行管理配置和终端界面在真实使用中是否可靠,仅凭榜单数据无法判断。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. pmndrs/pine让智能体订阅文件夹、命令、网页、Webhook 等事件并自主响应的终端式 Agent 运行框架。TypeScript117
  2. Balanov/shim面向终端的轻量本地优先 AI 代理框架,可接入任意模型 API、MCP 服务器和 Agent Skills。Go117
  3. deepseek-ai/deepseek-harnessDeepSeek 开源、以「一切皆插件」架构构建的 AI 智能体运行框架,适合本地运行与扩展智能体的开发者。TypeScript274,658
  4. KKKKhazix/agent-autoloop让命令行编程 Agent 按定时或事件在后台接活,遇到需要拍板的事再通知你。TypeScript3,225