agentty-org/agentty

AI pair programming in your terminal — one static binary, sub-ms startup, any model

什么是 agentty？

agentty 是一款在终端中运行的原生单二进制编码助手。它允许您与大型语言模型（Claude、GPT、Grok、Ollama 等）对话来编写、编辑和运行代码，同时自动检索仓库中最相关的部分，使模型只看到所需内容。整个工具用 C++26 编写，以约 16 MB 的静态可执行文件发布，支持 Linux、macOS、Windows，甚至 Android/Termux。

核心理念

理念	对您的意义
零运行时依赖	无需 Node、Python 或 `npm install`。只需下载二进制文件（或构建）并运行。
选择性检索（RAG）	内置混合 BM25 + 密集嵌入引擎仅获取重要的代码片段，与转储整个仓库相比，将提示上下文减少 80% 以上。
模型无关	适用于任何兼容 OpenAI 的端点、Claude、Groq、DeepSeek、Gemini、本地 Ollama 模型等。使用 `^P` 可随时切换提供商。
沙箱执行	Shell/构建命令在操作系统强制沙箱（Linux 上的 seccomp/landlock，macOS 上的 seatbelt）内运行，因此助手不会意外损坏您的系统。
气隙模式	当目标机器没有互联网时，agentty 可以通过 SSH 隧道的 SOCKS5 连接中继流量，保持会话隔离。
智能模式	编排器将简单轮次路由到廉价模型，并为规划密集型任务保留旗舰模型，自动学习每个仓库的适当努力级别。

主要功能（如 README 所述）

即时启动 – 冷启动低于 1 毫秒，按键到像素延迟约 1 毫秒。
完整工具套件 – 读/写/编辑、git、grep、search_docs、search_code、网络搜索、任务管理等，全部通过 TUI 暴露。
本地 RAG 引擎 – 混合 BM25 + HNSW 向量搜索、倒数排名融合、伪相关反馈、MMR 多样化、GraphRAG 扩展和可选生成式重排序器，全部在进程内用 C++ 实现。
沙箱命令 – Linux 使用 seccomp + landlock + cgroup2（回退 bubblewrap）；macOS 使用 seatbelt + rlimits（回退 sandbox-exec）。
气隙 SSH 中继 – agentty airgap user@host 设置 TLS 固定的 SOCKS5 隧道。
CLI 模式 – agentty run "fix the failing test" 用于一次性脚本，--json/--events 用于自动化，--read-only/--no-network 用于安全的 CI 运行。
键绑定 – Vim 风格快捷键，用于发送、导航线程、打开提供商选择器、切换智能模式、循环提示等。
与 Zed 集成 – 支持 Agent Client Protocol，因此您可以在 Zed 编辑器中将其用作 Claude-Code 的替代品。

快速开始（快速入门）

# 安装（Linux/macOS/Windows/Termux）——脚本会自动选择正确的包
curl -fsSL https://raw.githubusercontent.com/1ay1/agentty/master/install.sh | sh

cd /path/to/your/project
agentty               # 首次运行会打开 API 密钥的认证提示

您也可以通过包管理器安装：

Debian/Ubuntu：dpkg -i agentty_<version>_amd64.deb
Fedora/RHEL：dnf install https://…/agentty-<ver>-1.x86_64.rpm
macOS：brew tap 1ay1/tap && brew install agentty
Windows：scoop bucket add 1ay1 … && scoop install agentty 或 winget install agentty.agentty
使用 C++26 编译器从源码构建（git clone … && cmake -B build && cmake --build build）。

典型工作流程

打开仓库 – cd my‑app && agentty。
提问 – 输入类似 为登录处理器添加单元测试 的内容，然后按 Enter。
代理检索 – RAG 引擎提取最相关的代码片段，并以安静的 📚 卡片显示。
模型回复 – LLM 提出编辑建议，可能带有围栏代码块。
运行或应用 – 按 ^G 执行建议的命令，按 ^R 查看差异，或按 ^S 让智能模式规划多步骤重构。
迭代 – 继续聊天；工具保留线程历史，您可以随时使用 ^P 切换提供商。

谁可能受益？

偏好终端而非重型 IDE 扩展的开发者。
安全要求严格的团队 – 沙箱执行和气隙模式保护机密安全。
使用多个 LLM 提供商的人 – 同一个二进制文件适用于 Claude、OpenAI、Groq、本地 Ollama 等。
开源贡献者 – 该项目采用 MIT 许可，完全静态，可针对任何平台编译。

了解更多

文档 – https://agentty.org/docs（CLI、沙箱、检索、智能模式、按键绑定）。
对比 – https://agentty.org/compare/agentty-vs-claude-code、vs Aider、vs Cursor。
社区 – Discord、IRC 和 GitHub 问题跟踪器。

简而言之： agentty 是一款快速、自包含的终端编码助手，为任何操作系统带来现代 LLM 驱动的代码生成、上下文感知检索和安全沙箱执行，无需 Node/Python 生态系统的开销。