ai shell

将自然语言转换为 shell 命令的 CLI。

受到 GitHub Copilot X CLI 的启发，但对所有人开放源代码。

人工智能外壳

设置

Node.js 支持的最低版本是 v14

1. 安装ai外壳：

   npm install -g @builder.io/ai-shell

2. 从 OpenAI 检索您的 API 密钥

   注意：如果您还没有这样做，则必须创建一个帐户并设置计费。

3. 设置密钥以便 ai-shell 可以使用它：

   ai config set OPENAI_KEY= < your token >

   这将在您的主目录中创建一个.ai-shell文件。

用法

ai < prompt >

例如：

ai list all log files

然后您将得到如下输出，您可以在其中选择运行建议的命令、通过提示修改命令或取消：

◇  Your script:
│
│  find . -name " *.log "
│
◇  Explanation:
│
│  1. Searches for all files with the extension " .log " in the current directory and any subdirectories.
│
◆  Run this script ?
│  ● ✅ Yes (Lets go ! )
│  ○  Revise
│  ○  Cancel
└

特殊字符

请注意，某些 shell 会处理某些字符，例如?或*或看起来像文件路径的东西。如果您遇到奇怪的行为，您可以将提示括在引号中以避免出现问题，如下所示：

ai ' what is my ip address '

聊天模式

ai chat

使用此模式，您可以与 AI 进行对话，并直接通过 CLI 以自然的对话方式接收有用的响应：

┌  Starting new conversation
│
◇  You:
│  how do I serve a redirect in express
│
◇  AI Shell:

In Express, you can use the `redirect () ` method to serve a redirect. The ` redirect() ` method takes one argument, which is the URL that you want to redirect to.

Here ' s an example:

```js
app.get( ' /oldurl ' , (req, res) => {
  res.redirect( ' /newurl ' );
});
```

静音模式（跳过说明）

您可以使用标志-s或--silent禁用并跳过解释部分

ai -s list all log files

或使用以下命令将该选项保存为首选项：

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的默认语言为英语，但您可以通过相应的语言键轻松切换到您喜欢的语言，如下所示：

语言	钥匙
英语	zh
简体中文	zh-汉斯
繁体中文	zh-汉特
西班牙语	英语
日本人	日本人
韩国人	科
法语	FR
德语	德
俄语	茹
乌克兰	英国
越南语	六
阿拉伯	阿尔
葡萄牙语	点
土耳其	t

例如，如果您想切换到简体中文，可以通过将 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 向导，非常渴望访问副驾驶 CLI，并且变得不耐烦。

贡献

如果您想帮助修复错误或实现问题中的功能（提示：查找help wanted标签），请查看贡献指南以了解如何设置项目。

信用

• 感谢 GitHub Copilot 提供的出色工具和想法。
• 感谢 Hassan 和他在 aicommits 上的工作，这启发了工作流程以及代码和流程的某些部分