@huyooo/ai-chat-cli

终端 AI 对话工具，与业界 CLI（Claude Code、Aider、Gemini CLI、OpenCode）使用方式一致。

特性

• TUI 界面 - 现代化终端界面，支持快捷键和命令菜单
• 多行输入 - \ + Enter 换行
• 文件管理 - @ 引用文件，/add /drop 管理上下文
• 命令执行 - ! 执行 Shell 命令
• 网页抓取 - /web URL 抓取网页内容
• Git 集成 - /git 快速查看状态、diff、log
• Token 统计 - 实时显示 token 消耗
• 上下文压缩 - /compress 压缩长对话
• 自定义命令 - 定义可复用提示模板
• 会话管理 - 保存、恢复对话

安装

# npm 全局安装
npm install -g @huyooo/ai-chat-cli

# 或从源码安装
cd ai-chat/packages/ai-chat-cli
npm link

配置

# 设置 API Key（至少配置一个）
ai-chat config --set arkApiKey=YOUR_ARK_API_KEY
ai-chat config --set geminiApiKey=YOUR_GEMINI_KEY
ai-chat config --set qwenApiKey=YOUR_QWEN_KEY

# Web 搜索（可选）
ai-chat config --set tavilyApiKey=YOUR_TAVILY_KEY

# 查看配置
ai-chat config --list

配置文件：~/.ai-chat/config.json

使用

启动 TUI

ai-chat

界面：

◆ AI Chat • ask • doubao-seed-1-6          1.2k↑ 0.8k↓

你: 你好
AI: 你好！有什么我可以帮助你的吗？

❯ _

@ 文件 • / 命令 • ! Shell • \↵ 换行 • ^L 清屏

快捷键

| 按键 | 功能 | |------|------| | @ | 打开文件选择器 | | / | 打开命令菜单 | | !cmd | 执行 Shell 命令 | | \ + Enter | 多行输入 | | ↑↓ | 历史记录 | | Ctrl+L | 清屏 | | Ctrl+C | 取消生成/退出 | | Ctrl+D | 退出 | | t | 切换思考显示 |

命令

输入 / 打开命令菜单，或直接输入：

| 命令 | 说明 | |------|------| | /help | 显示帮助 | | /model | 选择模型 | | /mode ask\|agent | 切换模式 | | /add <file> | 添加文件到上下文 | | /drop [file] | 移除文件（不带参数移除全部）| | /files | 列出上下文文件 | | /web <URL> | 抓取网页内容 | | /git [cmd] | Git 命令（status/diff/log/branch）| | /compress | 压缩对话上下文 | | /tokens | 显示 Token 统计 | | /clear | 清空对话 | | /exit | 退出 |

非交互模式

# 单次查询
ai-chat -p "解释这段代码"

# 管道输入
cat error.log | ai-chat -p "分析这个错误"

# JSON 输出
ai-chat -p "1+1" --json

# 继续上次对话
ai-chat -c -p "继续"

经典模式

# 使用 readline 风格的经典界面
ai-chat --classic

自定义命令

在 .ai-chat/commands/ 创建 .md 文件定义自定义命令：

---
name: review
description: 代码审查
---

请审查以下代码，关注：
1. 代码质量
2. 潜在 bug
3. 性能问题

$ARGS

支持位置：

• ~/.ai-chat/commands/ - 全局命令
• .ai-chat/commands/ - 项目命令（优先）

命令菜单中自定义命令显示 ✦ 标记。

文件排除规则

创建 .aiignore 文件定义文件选择器排除规则：

# .aiignore
*.log
tmp/
secret/

支持位置：

• .aiignore - 项目根目录
• .ai-chat/ignore - 项目配置目录
• ~/.ai-chat/ignore - 全局配置

项目指令

类似 Claude Code 的 CLAUDE.md，支持项目级指令：

项目/
├── AI-CHAT.md              # 项目指令（优先）
├── .ai-chat/
│   └── instructions.md     # 备选位置

全局指令：~/.ai-chat/instructions.md

会话管理

ai-chat chat list           # 列出会话
ai-chat chat save <tag>     # 保存会话
ai-chat chat resume <tag>   # 恢复会话
ai-chat chat show <id>      # 显示详情
ai-chat chat delete <id>    # 删除会话

TUI 中使用 -c 继续上次对话：

ai-chat -c

与业界对比

| 特性 | Claude Code | Aider | Gemini CLI | ai-chat | |------|:-----------:|:-----:|:----------:|:-----------:| | TUI 界面 | ✅ | ✅ | ✅ | ✅ | | @ 文件引用 | ✅ | ✅ | ✅ | ✅ | | / 命令菜单 | ✅ | ✅ | ✅ | ✅ | | ! Shell | ✅ | ✅ | ✅ | ✅ | | 多行输入 | ✅ | ✅ | ✅ | ✅ | | /add /drop | ✅ | ✅ | ✅ | ✅ | | /web URL | ✅ | ✅ | ✅ | ✅ | | Git 集成 | ✅ | ✅ | ✅ | ✅ | | Token 统计 | ✅ | ✅ | ✅ | ✅ | | 上下文压缩 | ✅ | ✅ | ✅ | ✅ | | 自定义命令 | ✅ | ✅ | ✅ | ✅ | | .ignore | ✅ | ✅ | ✅ | ✅ | | 会话管理 | ✅ | ✅ | ✅ | ✅ |

CLI 参数

Usage: ai-chat [options] [message]

Options:
  -V, --version        版本号
  -p, --print          非交互式打印模式
  -c, --continue       继续上次对话
  -r, --resume <id>    恢复指定会话
  -m, --model <model>  指定模型
  --mode <mode>        对话模式 (ask/agent)
  --tui                使用 TUI 界面（默认）
  --classic            使用经典 readline 界面
  --search             启用 Web 搜索
  --think              启用深度思考
  --json               JSON 格式输出
  --no-instructions    禁用项目指令
  -h, --help           帮助信息

Commands:
  chat                 会话管理
  config               配置管理
  models               列出可用模型

License

MIT