OpenRouter CLI:一个专为软件开发者设计的终端AI助手
· 阅读需 7 分钟
OpenRouter CLI 是一款面向软件开发者的终端AI助手,它结合了多种AI模型强大能力与超高速的原生文件系统工具,通过交互式聊天界面帮助您理解代码库、直接从终端构建、调试和分析代码。
![]() |
---|
✨ 核心功能
🤖 多模型AI集成
- 多AI提供商支持:OpenRouter、OpenAI、Anthropic、Gemini等
- 模型切换:在对话中无缝切换GPT-4o、Claude、Gemini等模型
- 推理模式:支持在兼容模型上选择低/中/高推理强度
- 上下文感知:自动从
.buddyrules
、.cursorrules
、CLAUDE.md
等文件加载项目上下文
⚡ 超高速原生文件系统工具
- 14种原生工具调用:比传统MCP实现快5-10倍
- 文件操作:读取、写入、修改、删除、复制、移动文件(含高级安全检查)
- 目录管理:列表展示、创建、树状视图、递归操作
- 搜索与分析:内容搜索、文件模式匹配、代码分析
- 权限系统:基于路径白名单和审计日志的完善安全机制
🎨 专业终端界面
- 美观界面:支持语法高亮和主题的现代化TUI
- 快捷键:类似Vim的导航和效率快捷键
- 会话管理:支持多会话及历史记录持久化
- 文件浏览器:集成文件选择器和附件系统
- 实时更新:动态状态指示器和进度反馈
🔧 高级开发功能
- LSP集成:支持语言服务器协议提供智能代码辅助
- 代码生成:AI驱动的代码创建与修改
- 差异对比:美观的并排代码比较视图
- RAG系统:基于检索增强生成的代码库理解
- 智能编辑:上下文感知的代码修改与重构
🚀 快速开始
安装
下载二进制文件
访问我们的发布页面下载对应平台的二进制文件。
1. 选择对应版本
为您的平台选择合适版本:
# For macOS (Intel)
./dist/or-darwin-amd64
# For macOS (Apple Silicon)
./dist/or-darwin-arm64
# For Linux (Intel/AMD)
./dist/or-linux-amd64
# For Linux (ARM)
./dist/or-linux-arm64
# For Windows
./dist/or-windows-amd64.exe
2. 简易安装方法
选项 A:复制到系统 PATH(推荐)
# For macOS/Linux - copy to a directory in your PATH
sudo cp dist/or-darwin-arm64 /usr/local/bin/or
# Make executable
sudo chmod +x /usr/local/bin/or
# Now you can use it from anywhere
or
选项 B: 添加至路径
# Add the dist directory to your PATH
export PATH="$PWD/dist:$PATH"
# Add to your shell profile for permanent access
echo 'export PATH="$PWD/dist:$PATH"' >> ~/.bashrc # for bash
echo 'export PATH="$PWD/dist:$PATH"' >> ~/.zshrc # for zsh
``
### 3. 首次设置
#### 设置您的 API 密钥
```bash
# Set OpenRouter API key
export OPENROUTER_API_KEY="您的-api-密钥"
# Add to your shell profile for permanent access
echo 'export OPENROUTER_API_KEY="您的-api-密钥"' >> ~/.bashrc # for bash
echo 'export OPENROUTER_API_KEY="您的-api-密钥"' >> ~/.zshrc # for zsh
配置
- 设置您的API密钥:
export OPENROUTER_API_KEY="您的-api-密钥"
- 首次运行:
or
该应用程序将在您的项目目录中创建一个.openrouter.json
配置文件,并提供合理的默认配置。
🎯 使用示例
交互模式
# 启动 OpenRouter CLI
or
# 启动于指定目录
or -c /path/to/project
非交互模式
# Single prompt execution
or -p "Explain this Go code structure"
# JSON output format
or -p "List all Go files in this project" -f json
# Quiet mode (minimal output)
or -p "Check for security issues" -q
示例对话
代码库分享:
你:你能分析这个 Go 项目结构并解释其主要组件吗?
AI:我将使用我的文件系统工具分析你的代码库。让我来探索一下结构...
[使用 list_directory 和 read_file 工具]
这是一个结构良好的 Go CLI 应用程序,具有以下架构:
- cmd/ - 使用 Cobra 定义的 CLI 命令
- internal/ - 核心应用逻辑,具有清晰的分离
- internal/tui/ - 使用 Bubble Tea 框架的终端 UI
- internal/llm/ - 与多个提供商的 AI 集成
- internal/tools/ - 本地文件系统工具(14 个超快工具)
...
代码生成:
你:创建一个基于JWT令牌的用户身份认证REST API处理器
AI:我会为你创建一个全面的认证处理器...
[使用 write_file 和 create_directory 工具来生成代码]
已创建以下文件:
- handlers/auth.go - JWT认证处理器
- middleware/auth.go - 认证中间件
- models/user.go - 包含验证功能的用户模型
- utils/jwt.go - JWT令牌工具
...
🛠️ 文件系统工具调用
OpenRouter CLI 包含 14 个超高速的原生文件系统工具,按功能分类如下:
📁 文件操作
read_file
- 读取完整文件内容,支持编码检测write_file
- 创建或覆盖文件,支持备份modify_file
- 查找并替换文本,支持正则表达式delete_file
- 安全删除文件,带确认提示copy_file
- 复制文件和目录,带进度跟踪move_file
- 移动或重命名文件,带冲突解决get_file_info
- 详细的文件元数据和统计信息read_multiple_files
- 高效批量读取多个文件
📂 目录操作
list_directory
- 列出内容并显示详细信息create_directory
- 递归创建目录tree
- 显示目录树结构,支持过滤list_allowed_directories
- 显示可访问的目录
🔍 搜索操作
search_files
- 按名称、扩展名或模式查找文件search_within_files
- 内容搜索,支持正则表达式
⌨️ 键盘快捷键
快捷键 | 功能 |
---|---|
Ctrl+C | 退出应用 |
Ctrl+O | 打开模型选择 |
Ctrl+S | 切换会话 |
Ctrl+F | 打开文件选择器 |
Ctrl+T | 切换文件系统工具 |
Ctrl+D | 切换调试模式 |
Ctrl+? | 显示帮助 |
Ctrl+R | 刷新界面 |
Tab | 自动补全 |
↑/↓ | 浏览历史记录 |
🔧 配置
主配置文件 (.openrouter.json
)
{
"providers": {
"openrouter": {
"apiKey": "your-api-key",
"disabled": false
}
},
"agents": {
"coder": {
"model": "openrouter.claude-sonnet-4",
"maxTokens": 16438,
"reasoningEffort": "medium"
},
"task": {
"model": "openrouter.gpt-4o",
"maxTokens": 4096
}
},
"data": {
"directory": ".openrouter"
},
"tui": {
"theme": "openrouter"
},
"lsp": {
"go": {
"command": "gopls",
"args": ["serve"],
"disabled": false
}
}
}
LSP 配置
配置 Language Server Protocol 集成以实现智能代码辅助:
{
"lsp": {
"go": {
"command": "gopls",
"args": ["serve"]
},
"typescript": {
"command": "typescript-language-server",
"args": ["--stdio"]
},
"python": {
"command": "pylsp"
}
}
}
🚀 性能
基准测试
- 原生工具:比传统 MCP 实现快 5-10 倍
- 内存占用:优化低内存占用(通常约 50MB)
- 启动时间:冷启动在 500 毫秒内
- 文件操作:并行处理与智能缓存
优化功能
- 并发处理:并行文件操作与 AI 请求
- 智能缓存:文件内容与 AI 响应的智能缓存
- 内存管理:通过垃圾回收优化实现高效内存使用
- 连接池:重用 AI 提供商连接
🔒 安全
权限系统
- 路径白名单:限制文件访问至批准目录
- 操作审计:文件操作全面日志记录
- 安全默认值:保守权限设置,危险操作需显式启用
- 备份系统:破坏性操作前自动备份
最佳实践
- API 密钥管理:支持环境变量与安全存储
- 输入验证:全面验证用户输入与 AI 响应
- 错误处理:优雅的错误处理与详细日志记录
- 审计追踪:完整记录所有操作
性能监控
- 内置性能分析:支持内存与 CPU 分析
- 工具使用统计:跟踪文件系统工具使用与性能
- 会话分析:会话长度、模型使用情况及响应时间