reagent (Fsmiamoto)

试剂

关于您的观点 代理

为什么这很有用？

在人工智能编码助手的时代，确保其输出代码的高质量对于维护健康的代码库至关重要。

这通常需要提供详细的、特定于行的反馈，就像处理人类队友的代码一样。

但是通过聊天指向特定的行是笨拙的，为正在进行的本地工作设置GitHub PR真的太过分了。

ReAgent通过创建一个轻量级的MCP服务器来解决这个问题，该服务器在您的浏览器中打开一个熟悉的GitHub风格的审查界面，以加快您的反馈周期。

ReAgent Usage

Plan Review

特性

• 基于浏览器的交互式代码审查UI
• 带文件树导航的行级注释
• 批准或请求更改工作流
• Git集成：审查未提交的更改、特定提交或分支差异
• 本地文件审查：审查任意文件

用法

1. 将其作为MCP服务器添加到您最喜欢的代理编码工具中。

{
  "mcpServers": {
    "reagent": {
      "command": "npx",
      "args": [
        "-y",
        "@fsmiamoto/reagent@latest",
        "mcp"
      ]
    }
  }
}

提示

建议使用ReAgent的方法是，每当您想创建审核会话时，都可以引导您的代理。

> Let's plan a change to [...]. Write the plan as a markdown file on the plans/ directory and create a review session.

您还可以将ReAgent指令添加到AGENTS.md（或您的代理加载的任何上下文文件）中，以自动执行审核：

- You MUST create a review session using ReAgent and get approval before proceeding to implementation.

两步工作流程

ReAgent使用两步工作流来实现基于浏览器的交互式代码审查：

1. create_review：启动审阅会话并返回URL。
2. get_view：检索已完成的审核结果。

命令行用法

ReAgent还提供了一个命令行界面，用于创建和管理审阅会话。

对于高级用户，您还可以通过教导代理调用命令来直接使用CLI，而无需MCP(了解更多).

安装

全局安装ReAgent以使用CLI：

npm install -g @fsmiamoto/reagent

验证安装：

reagent --version

或者，使用 npx 无需安装：

npx @fsmiamoto/reagent review

发展

对于贡献者来说，这个项目需要Bun来开发：

# Install dependencies
bun install

# Build the project
bun run build

# Run tests
bun run test

# Start development server with watch mode
bun run dev

命令

reagent start

启动ReAgent web服务器。

reagent start                  # Start on default port (3636)
reagent start --port 8080      # Start on a custom port
reagent start --detach         # Start in the background (daemon mode)

该端口也可以通过以下方式配置 REAGENT_PORT 环境变量。优先： --port 旗帜> REAGENT_PORT >默认值（3636）。

面向用户的URL（例如，查看链接）中使用的主机名可以通过以下方式配置 --host 旗帜或 REAGENT_HOST 环境变量。在远程计算机上运行时，这很有用。优先： --host 旗帜> REAGENT_HOST >默认值(localhost).

reagent start --host tokyo        # URLs will use http://tokyo:3636/...
REAGENT_HOST=tokyo reagent start  # Same effect via env var

reagent stop

停止正在运行的ReAgent web服务器。

reagent stop           # Graceful stop
reagent stop --force   # Force stop (SIGKILL)

reagent status

显示ReAgent web服务器的状态。

reagent status          # Human-readable output
reagent status --json   # Machine-readable JSON output

reagent review

从git更改或本地文件创建新的代码审查会话。

# Review uncommitted changes (default)
reagent review --auto-start

# Review a specific commit
reagent review --source=commit --commit=abc123

# Compare two branches
reagent review -s branch --base=main --head=feature

# Review specific local files
reagent review --source=local src/file.ts src/other.ts

# With title and description
reagent review --title "Auth refactor" --description "Splitting middleware"

# Don't open browser automatically
reagent review --no-open

这 --auto-start 如果服务器尚未运行，则标志在后台启动服务器。

默认情况下，审核URL会在浏览器中打开。

reagent get

获取审核状态和结果。

reagent get           # Show status and comments
reagent get  --wait   # Poll until the review is completed
reagent get  --json   # Output as JSON

reagent list

列出当前正在进行的审核会话。

reagent list

reagent mcp

启动MCP服务器（stdio传输）。这是MCP服务器配置中使用的命令——您通常不会直接运行它。

许可证

麻省理工学院