SynapsCLI：终端 AI Agent 运行时

项目简介

SynapsCLI（命令 synaps）是一个用 Rust 编写的终端原生 AI Agent 运行时。它能从单个约 32 MB 的二进制文件出发，在你的终端里运行一组 AI Agent，并支持任意模型。

它面向已经长期在终端里工作的开发者：Agent 被当作程序而不是聊天框，可以像服务一样运行。系统提示词是磁盘上的一个文件，工具列表可以关闭，程序也不会向外发送数据。

主要功能

• 会话独立于窗口存在：后台 daemon 管理所有会话，/sessions 列出会话，被 pin 的会话在重启后恢复。
• 多终端接入同一会话：可以挂多个客户端到同一会话，任意一个都能输入、引导或接管。
• 并行 subagent：命名子 Agent 并行工作，可单独打开某个子 Agent 的视图并中途引导。
• 任意模型：Claude、Codex、Grok、Copilot、Gemini、Kimi、Meta Muse，以及 Azure OpenAI、Amazon Bedrock、Google Vertex AI、任何 OpenAI 兼容端点和 Ollama。模型按 <provider>/<model> 指定。
• 凭证留在 broker：Agent 拿到的是短期、受限范围的 token，而不是你的密钥；同一 provider 可配置多个账号。
• 可选的回合限制：可对轮数、工具调用次数、时间、token 和成本设置上限。
• 长会话控制开销：Claude 订阅下提示缓存持续一小时，较大的工具输出存到磁盘、只保留简短预览，未修改文件的重读会去重，worker 的上下文是滚动使用而不是塞满窗口。
• 持久记忆：项目记忆、/compact 检查点，以及可跨天串联的会话。
• 多模态输入：模型可以读图像，/attach 可把图片、PDF 和文本加入当前回合。
• 可扩展：支持任意语言的扩展、MCP 服务器，以及通过 JSON-RPC 或 WebSocket 调用引擎。
• 主题：内置 21 个主题（如 catppuccin、gruvbox、nord、tokyo-night、neon-rain、浅色 paper），用 /theme 即时切换，或用 SYNAPS_THEME=<name> 单次生效。

安装与使用

支持 Linux、macOS 和 Windows 10/11（x64）。

Linux / macOS：

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/HaseebKhalid1507/SynapsCLI/releases/latest/download/synaps-installer.sh | sh
brew install HaseebKhalid1507/tap/synaps

Windows（PowerShell）：

powershell -ExecutionPolicy Bypass -c "irm https://github.com/HaseebKhalid1507/SynapsCLI/releases/latest/download/synaps-installer.ps1 | iex"

其他方式：cargo install synaps（需要 Rust 1.88+）、yay -S synaps（Arch），或从 releases 页面获取 .deb、synaps-x86_64-pc-windows-msvc.zip。

启动：

synaps login     # 选择 provider：订阅、API key、云服务或本地模型
synaps           # 打开 TUI

常用子命令：synaps attach（接入 daemon 会话的行模式客户端）、synaps daemon（status、sessions、pin、rename、close、stop、reload、reload-extension）、synaps send（从脚本向运行中的会话发消息）、synaps chat（标准输入输出模式，适合管道、脚本和 CI）、synaps rpc（stdio 上的 JSON-RPC，用于嵌入其他软件）、synaps server（带 token 鉴权和流式输出的 WebSocket API）。

配置集中在一个文件 ~/.synaps-cli/config，格式为 key = value：

model = anthropic/claude-opus-5
thinking = high
theme = tokyo-night
disabled_tools = bash, ls

注意事项

• 没有沙箱：工具以你本人的权限运行。
• 它是终端优先的工具，不提供 IDE 插件或桌面应用。
• 项目较年轻、迭代很快，升级前建议先读升级说明。v0.11.1 有多项默认值变化：worker 不再获得 disabled_tools 中列出的工具，bash 工具除 sudo 外不再响应密码提示。
• 云路由（Azure OpenAI、Amazon Bedrock、Google Vertex AI）目前仅支持文本；需要工具的模式会在使用凭证前直接失败。
• Windows 上的 bash 工具依赖 Git Bash 或 WSL 的 bash.exe，两者都没有时会报 not-found；需要使用 bash 请安装 Git for Windows。
• google-gemini provider 需要 Synaps 自有的 Google Desktop OAuth 客户端注册。

---

本作品整理自 GitHub 开源项目 HaseebKhalid1507/SynapsCLI，原作者 @HaseebKhalid1507，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。