BuilderIO/ai-shell
BuilderIO/ai-shell has 5,309 GitHub stars and 375 forks. GitHot measured 0 stars in 24 hours, +1 in 7 days, and +2 in 15 days. Last checked 2026-11-21 02:33 UTC. Last push 2026-01-05.
实测星标增长
- 24小时
- 0
- 7天
- +1
- 15天
- +2
- 1个月
- 正在收集历史
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
关于
一个将自然语言转换为 Shell 命令的 CLI。
开发工具README-zh-Hans.md
原文一个将自然语言转换为 Shell 命令的 CLI。
受 GitHub Copilot X CLI 启发, 但是面向所有人开源.
AI Shell
安装
最低支持的 Node.js 版本是 v14
安装 ai shell:
npm install -g @builder.io/ai-shell从 OpenAI 获取您的 API 密钥
注意:如果您还没有创建帐户并设置计费方式,您需要先进行这些步骤。
设置密钥以便 ai-shell 可以使用它:
ai config set OPENAI_KEY=<your token>这将在您的主目录中创建一个名为
.ai-shell的文件。
使用
ai <prompt>
例如:
ai 查找所有.log文件
然后您将会得到如下输出,您可以选择运行建议的命令、通过提示修改命令或者取消:
◇ 您的脚本:
│
│ find . -name "*.log"
│
◇ 解释:
│
│ 这个脚本的步骤如下:
│ 1. 在当前目录下搜索所有后缀为".log"的文件。
│ 2. 输出所有找到的文件的路径。
│
◆ 运行这个脚本?
│ ● ✅ 是 (开始运行吧!)
│ ○ 📝 修改
│ ○ ❌ 取消
└
特殊字符
请注意,某些 shell 会处理某些特殊字符,如 ? 或 * 或看起来像是文件路径的字符。如果您遇到奇怪的行为,可以将提示符用引号括起来以避免问题,例如下面的示例:
ai '我的 IP 地址是什么?'
聊天模式

ai chat
通过此模式,您可以直接通过 CLI 与 AI 进行对话,并以自然、对话式的方式获得有用的响应:
┌ 开始新的对话
│
◇ 您:
│ 在 Express 中如何进行重定向服务?
│
◇ AI Shell:
在 Express 中,您可以使用 `redirect()` 方法来进行重定向服务。`redirect()` 方法接受一个参数,即您要重定向到的 URL。
以下是一个示例:
\`\`\`js
app.get('/oldurl', (req, res) => {
res.redirect('/newurl');
});
\`\`\`
静默模式(跳过解释)
您可以使用 -s 或 --silent 标志来禁用和跳过解释部分。
ai -s 列出所有日志文件
或者使用以下命令将选项保存为首选项:
ai config set SILENT_MODE=true
自定义 API 端点
您可以自定义 OpenAI API 端点以设置 OPENAI_API_ENDPOINT(默认值为 https://api.openai.com/v1)。
ai config set OPENAI_API_ENDPOINT=<your proxy endpoint>
设置语言

AI Shell 的默认语言是英文,但您也可以参考下列语言对应的键,来设置您需要的语言界面:
| 语言 | 键值 |
|---|---|
| English | en |
| 简体中文 | zh-Hans |
| 繁体中文 | zh-Hant |
| Español | es |
| 日本語 | jp |
| 한국어 | ko |
| Français | fr |
| Deutsch | de |
| Русский | ru |
| Українська | uk |
| Tiếng Việt | vi |
| العربية | ar |
| Português | pt |
例如,您要将语言设置为简体中文,可以在设置 LANGUAGE 的值为 zh-Hans:
ai config set LANGUAGE=zh-Hans
这样您的语言就设置为了简体中文
配置界面
如果要使用更可视化的界面查看和设置配置选项,可以键入:
ai config
要获取如下所示的交互式 UI:
◆ Set config:
│ ○ OpenAI Key
│ ○ OpenAI API Endpoint
│ ○ Silent Mode
│ ● Model (gpt-4o-mini)
│ ○ Language
│ ○ Cancel
└
升级
使用以下命令检查已安装的版本:
ai --version
如果它不是最新版本,请运行:
npm update -g @builder.io/ai-shell
或者只需使用 AI shell:
ai update
常见问题
429 错误
一些用户报告了来自 OpenAI 的 429 错误。这是由于错误的计费设置或过度使用配额所致。请按照此指南进行修复。
您可以在此链接上激活计费。如果没有获得 OpenAI 的活动赠款,请确保添加支付方式。
动机
我不是一个 bash 巫师,迫切需要访问 copilot CLI,但我已经等不急了。
贡献
如果您想在 Issues 中修复错误或实现功能(提示:注意 help wanted 标签),请查看 Contribution Guide 以了解如何设置项目。
致谢
- 感谢 GitHub Copilot 提供的惊人工具和这个想法
- 感谢 Hassan 和他在 aicommits 上的工作,这启发了工作流程和部分代码和流程。
社区
欢迎加入 Builder.io Discord 并在 #ai-shell 房间与我们聊天。