y-cli 🚀

一个将AI对话带入终端的小型命令行界面聊天应用。

查看y-gui以获取y-cli的基于Web的版本。

✨ 特性

• 📝 灵活的存储选项：
  • 使用本地JSONL文件进行轻松访问和同步
  • 使用Cloudflare D1进行云存储
• 💬 带有工具执行可视化功能的交互式聊天界面
• 🤖 支持多种机器人配置（任何base_url/api_key/model组合）。支持的API格式类型：
  • OpenAI聊天完成流式传输格式
  • Dify聊天消息流式传输格式
• 🤔 支持推理模型
  • 打印Deepseek-r1推理内容
  • 配置OpenAI o3-mini推理努力
• 🔗 MCP（模型上下文协议）集成：
  • 客户端支持多种服务器配置（stdio/SSE）
  • 持久守护进程
  • 自定义提示配置
• 🧐 通过提示配置实现简单的“深度研究”模式
  • 演示

演示

asciicast

多种机器人配置

➜  ~ y-cli bot list
Name         API Key      API Type    Base URL                             Model                                Print Speed    Description    OpenRouter Config    MCP Servers    Reasoning Effort
-----------  -----------  ----------  -----------------------------------  -----------------------------------  -------------  -------------  -------------------  -------------  ------------------
default      sk-or-v1...  N/A         https://gateway.ai.cloudflare.co...  google/gemini-2.0-flash-001          None            N/A            Yes                  No             N/A
claude       sk-or-v1...  N/A         https://gateway.ai.cloudflare.co...  anthropic/claude-3.7-sonnet:beta     None             N/A            Yes                  todo           N/A
o3-mini      sk-or-v1...  N/A         https://gateway.ai.cloudflare.co...  openai/o3-mini                       None             N/A            Yes                  No             low
ds-chat        sk-or-v1...  N/A         https://gateway.ai.cloudflare.co...  deepseek/deepseek-chat-v3-0324:free                 None            N/A            Yes                  tavily         N/A
dify-bot     app-2drF...  dify        https://api.dify.ai/v1                                                    None             N/A            No                   No             N/A

多个MCP服务器

➜  ~ y-cli mcp list
Name            Type    Command/URL          Arguments/Token    Environment     Auto-Confirm
--------------  ------  -------------------  -----------------  --------------  --------------
brave-search    sse     https://router.m...                                     brave_web_s...
todo            stdio   uvx                  mcp-todo
exa-mcp-server  stdio   npx                  exa-mcp-server     EXA_API_KEY...

⚡ 快速开始

先决条件

所需：

1. uv
2. OpenRouter API密钥

设置说明：

1. uv

   • 遵循官方安装指南
   • uv会自动管理Python安装

2. OpenRouter API密钥

   • 访问OpenRouter设置
   • 创建一个新的API密钥
   • 在初始化步骤中保存它

不安装运行

uvx y-cli

使用uv工具安装

uv tool install y-cli

初始化

y-cli init

开始聊天

y-cli chat

🛠️ 使用方法

y-cli [OPTIONS] COMMAND [ARGS]...

命令

• chat 启动新的聊天对话或继续现有的对话
• list 列出聊天对话，可选过滤
• share 分享聊天对话，生成可分享的链接
• import 从外部文件导入聊天记录（用于存储迁移）
• bot 管理机器人配置：
  • add 添加新的机器人配置
  • list 列出所有已配置的机器人
  • delete 删除机器人配置
• mcp 管理MCP服务器配置：
  • add 添加新的MCP服务器配置
  • list 列出所有已配置的MCP服务器
  • delete 删除MCP服务器配置
• daemon 管理MCP守护进程：
  • start 启动MCP守护进程
  • stop 停止MCP守护进程
  • status 查看守护进程状态
  • log 查看守护进程日志
  • restart 重启守护进程
• prompt 管理提示配置：
  • add 添加新的提示配置
  • list 列出所有已配置的提示
  • delete 删除提示配置

选项

• --help 显示帮助信息并退出

📚 文档

访问deepwiki页面以获取全面的项目文档和指南。