@sinlair/reagent
v0.1.11
Published
Local-first research workspace and runtime CLI
Readme
为什么是 ReAgent
ReAgent 适合那些不想把研究工作做成“一次性聊天记录”的人。
- 用结构化 brief 取代零散 prompt。
- 用 durable memory 取代只靠上下文窗口的短期记忆。
- 让 jobs、hooks、sessions、artifacts 都能被检查,而不是躲在黑盒编排里。
- 让报告、评审、演示稿、workstream 可以被重新打开和复用,而不是每次重跑。
快速开始
安装正式发布包:
npm install -g @sinlair/reagent首次启动路径:
reagent onboard
reagent onboard --apply
reagent home
reagent service run默认 Web Console 地址:
http://127.0.0.1:3000/安全起步配置使用 fallback + mock。
它适合试用和 walkthrough,不适合作为最终研究质量配置。
一个典型流程
先排队任务,再检查进度,最后回看可复用产物:
reagent research directions
reagent research enqueue "multimodal web agents" --question "哪些开源基线最强?"
reagent research tasks
reagent research report <taskId>
reagent research handoff <taskId>
reagent memory recall "recent research choices"你会得到什么
- 一套常驻 runtime,同时覆盖 research、memory、channels、jobs 和交付物。
- 以 CLI 为主控制面,Web Console 为辅的检查面。
- 可持久回看的 briefs、tasks、reports、reviews、presentations、workstreams、module assets。
- 本地可检查的 LLM routes、MCP servers、workspace skills 和 inbound command policy。
- 需要时可接入 WeChat 与 OpenClaw,用于消息投递和 host state 检查。
核心产品表面
当前最主要的五个表面是:
reagent research ...排队研究任务、查看状态、重新打开 artifacts,并驱动 discovery、synthesis、handoffreagent memory ...写入长期笔记、执行 recall / search,以及手动或定时 compactionreagent agent ...查看 runtime sessions、hooks、profiles、history、host linkage 和受限 delegationreagent channels ...通过mock、native、openclawprovider 接收或推送消息reagent workspace ...管理 snapshots、restore preview、support bundle 和本地配置状态
仓库结构
这些目录分别承担不同职责:
src/ReAgent 主 runtime、CLI、HTTP routes、providers 与 servicestests/已发布产品表面的回归与集成测试docs/面向用户的文档、walkthrough、release notes 与定位说明web/配套 Web Console 资源package/配套的 OpenClaw Weixin 包,不是主产品安装入口upstream/openclaw/为兼容性与对齐工作保留的上游快照,不是 ReAgent 功能开发的主编辑区
文档入口
建议从这里开始:
- Docs Hub
- Public Install And Quickstart
- Core Product Flows
- Public Walkthroughs
- OpenClaw Host Surface
- Positioning: ReAgent vs Hermes Agent
- Developer Extensions
- Operations
定位
ReAgent 是 research-first workspace,不是薄薄一层聊天壳,也不是一个泛用 agent shell。
它会借鉴 Hermes Agent 和 OpenClaw 的一些 runtime 设计:
- Hermes Agent 提供 hooks、tool orchestration、skills、jobs、受限 delegation 等 runtime seams 参考。
- OpenClaw 提供 bridge 与 host surface 兼容参考,用于需要渠道投递时的对接。
但 ReAgent 的核心价值仍然是 durable research work、durable memory 和 reusable artifacts。
灵感来源
ReAgent 参考了这些项目:
License
采用 MIT License。
