1ay1/agentty

What it solves

agentty 是一个高性能的基于终端的编程代理，旨在取代速度较慢、依赖运行时的工具（例如基于 Node.js 或 Python 构建的工具）。它通过使用本地检索系统仅发送最相关的代码片段，解决了“上下文倾倒”问题（即代理将整个代码库发送给 LLM 的问题），从而减少了上下文使用量和成本。

How it works

agentty 使用 C++26 编写，作为一个单一的静态二进制文件，以原生应用的形式运行，具有毫秒级的启动时间。它采用了一种复杂的本地 RAG（检索增强生成）引擎，结合了 BM25 关键词搜索、稠密嵌入（dense embeddings）和 GraphRAG 来获取精确的代码和文档。它支持广泛的 LLM 提供商（Claude, OpenAI, Groq, Ollama 等），并具有“Smart Mode”功能，该功能使用编排器-工作者（orchestrator-worker）架构，根据任务复杂度在旗舰模型和更便宜的模型之间委派任务。

Who it’s for

它是为那些想要一个快速、与供应商无关的编程助手而设计的，该助手直接在终端中运行，支持离线工作（通过本地模型），并通过沙盒化的 shell 执行来保持严格的安全性。

Highlights

• Native Performance: 单一静态二进制文件，冷启动约 3ms，且零运行时依赖。
• Advanced Local RAG: 混合检索（BM25 + embeddings），GraphRAG，以及重排序（reranking）以最大限度地减少上下文窗口膨胀。
• Model Agnostic: 支持多种提供商，包括 Claude, OpenAI, DeepSeek, 和本地 Ollama 模型，并支持实时切换。
• Security First: 针对 shell/build 命令的默认沙盒化，以及用于通过 SSH 进行安全远程执行的物理隔离模式（air-gapped mode）。
• Smart Mode: 一个编排器-工作者系统，根据任务的复杂度来扩展投入程度和模型成本。
• Zed Integration: 兼容 Agent Client Protocol (ACP)，可在 Zed 编辑器中使用。