@sinlair/reagent
Advanced tools
Turn ongoing research into a reusable workflow, not a one-off conversation.
Local-first research workspace for paper discovery, evidence review, research notes, and delivery.
ReAgent is not a chatbot with a few research buttons attached. It is a local research workspace designed for people who need to revisit topics, review evidence, save context, and ship useful outputs.
It is built for workflows such as:
It fits best when you need a controllable, inspectable workspace rather than a black-box assistant.
The current web UI is organized around a small set of working surfaces:
Workbench for current progress, latest results, and common next actions.Main Workspace for chat, quick research actions, recent tasks, and current workspace context.Status for activity, latest outputs, and system health.Research Workspace for templates, task lists, reports, schedules, topic reports, slides, and module files.Research Map for seeing how topics, evidence, reports, and files connect.Research Notes for searching, saving, and reopening file-backed notes.Channels for WeChat login, connection status, lifecycle changes, and channel events.Agent Settings and Skills for choosing the role, model, and tools used by chat..env.example.npm install
npm run db:push
npm run dev
Open http://127.0.0.1:3000/.
Minimal local setup:
LLM_PROVIDER=fallback
WECHAT_PROVIDER=mock
If PowerShell blocks npm, use npm.cmd instead.
Global CLI install:
npm install -g @sinlair/reagent
reagent init
reagent gateway
The published package name is @sinlair/reagent, while the installed command is reagent.
Always-on gateway lifecycle:
reagent gateway install
reagent gateway status
reagent gateway restart
reagent gateway stop
The root app can run as a foreground dev process or as an always-on background service.
| Mode | Commands | Notes |
|---|---|---|
| Development | npm run dev | Local development with live reload |
| PM2 | npm run pm2:start / npm run pm2:restart / npm run pm2:logs | Keep the app running in the background |
| Windows Service | npm run service:install / npm run service:status / npm run service:start / npm run service:stop | Machine-level runtime on Windows |
See OPERATIONS.md for deployment and maintenance details.
| Path | Purpose |
|---|---|
./ | Root ReAgent app, web UI, API server, and runtime |
packages/reagent-core/ | Reusable core research logic |
packages/reagent-openclaw/ | Installable OpenClaw plugin package |
package/ | In-repo OpenClaw WeChat reference package kept for compatibility work |
docs/ | Product visuals and supporting docs |
Validation:
npm run check:all
npm run test
If you only want to validate the publishable packages:
npm run build:packages
npm run check:packages
Install the ReAgent OpenClaw plugin with:
openclaw plugins install @sinlair/reagent-openclaw --yes
Plugin source lives in packages/reagent-openclaw/.
ReAgent is shaped by research-agent and research-workspace projects such as:
For a closer comparison, see docs/research-agent-landscape.md.
Released under the MIT License.
FAQs
Local-first research workspace and runtime CLI
The npm package @sinlair/reagent receives a total of 1 weekly downloads. As such, @sinlair/reagent popularity was classified as not popular.
We found that @sinlair/reagent demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Threat Research
/Security News
Socket uncovered secret-stealing workflows that ran in LiteLLM’s GitHub repository 11 days before the supply chain attack on PyPI and Docker.
Security News
Cloudflare introduces tsrs, a Rust port of TypeScript’s compiler promising faster checks and lower memory use, with the TypeScript team’s help.
Security News
The PHP Foundation says Chainguard broke a security embargo ahead of critical RCE patches, as leaks disrupted the coordinated release.