Rlm Tools

🚀 RLM Tools

RLM Tools 是一款能為 AI 編碼代理提供持久沙盒環境以探索代碼的工具。在大型代碼庫中，AI 編碼代理大部分的令牌預算都花費在讀取代碼上，而非對代碼進行推理。而 RLM Tools 能讓數據留在服務器端，僅將結論返回，有效減少上下文佔用，提升編碼效率。

🚀 快速開始

你可以使用以下命令一鍵安裝 RLM Tools：

# 使用 Claude Code 安裝
claude mcp add rlm-tools -- uvx rlm-tools

# 或者使用 Codex 安裝
codex mcp add rlm-tools -- uvx rlm-tools

安裝完成後，代理會自動使用沙盒進行代碼探索，無需額外配置或更改提示。

✨ 主要特性

減少上下文佔用

在典型的編碼工作流程中，使用 RLM Tools 可減少 25 - 35% 的上下文佔用，這意味著代理在達到上下文限制之前可以探索大約多 40 - 50% 的代碼。在大量探索任務（如讀取多個文件、廣泛搜索）中，節省的效果更為顯著：

完整的基準測試方法和復現步驟請參考：

高效探索代碼

RLM Tools 提供了一個服務器端的 Python 沙盒，代理可以在其中運行探索代碼，數據保留在沙盒內存中，僅將 print() 輸出傳遞到上下文中。例如，在搜索 import UIKit 時，原本 500 行的 grep 結果可以簡化為 5 行摘要：

matches = grep("import UIKit")
by_module = {}
for m in matches:
    module = m["file"].split("/")[0]
    by_module.setdefault(module, []).append(m)
for module, ms in sorted(by_module.items(), key=lambda x: -len(x[1]))[:5]:
    print(f"{module}: {len(ms)} files")

📦 安裝指南

一鍵安裝

# 使用 Claude Code 安裝
claude mcp add rlm-tools -- uvx rlm-tools

# 或者使用 Codex 安裝
codex mcp add rlm-tools -- uvx rlm-tools

其他安裝方法

{
  "mcpServers": {
    "rlm-tools": {
      "command": "uvx",
      "args": ["rlm-tools"]
    }
  }
}

uvx rlm-tools

git clone https://github.com/stefanoshea/rlm-tools.git
cd rlm-tools
uv sync
uv run rlm-tools

💻 使用示例

基礎用法

使用 RLM Tools 的三個核心 MCP 工具：

高級用法

沙盒提供了一些內置輔助函數：

• read_file(path) / read_files(paths) — 將文件讀取到變量中（跨調用緩存）
• grep(pattern) / grep_summary(pattern) / grep_read(pattern) — 搜索
• glob_files(pattern) — 根據模式查找文件
• tree(path, max_depth) — 顯示目錄結構
• llm_query(prompt, context) — 子 LLM 分析（可選，需要 API 密鑰）

變量在會話內的 rlm_execute 調用之間保持持久化，代理可以逐步建立理解，進行搜索、過濾、讀取和分析，而無需將任何中間數據放入上下文窗口。

📚 詳細文檔

配置

複製 .env.example 到 .env 進行自定義配置。所有設置都是可選的，RLM Tools 無需配置即可直接使用。

安全

沙盒是隻讀且受限的：

• 導入：僅允許安全的標準庫（如 re、json、collections、math 等）
• 內置函數：阻止 exec、eval、compile、__import__、breakpoint
• 文件訪問：只讀，作用域限於會話目錄，阻止路徑遍歷
• 執行：可配置每次調用的超時時間（默認 30 秒）
• 速率限制：可配置每個會話的最大調用次數

🔧 技術細節

RLM Tools 實現了一個 RLM 風格 的探索循環，將原始數據保留在工具端內存中，僅將緊湊的輸出發送到模型。它基於 Model Context Protocol 構建。

🏗️ 開發

git clone https://github.com/stefanoshea/rlm-tools.git
cd rlm-tools
uv sync --dev
pytest tests

運行比較基準測試（需要本地項目檢出）：

RLM_EVAL_PROJECT_PATH=/path/to/project pytest evals -q -s

📄 許可證

本項目採用 MIT 許可證。