@caffeineai/cli

中文文档
0.2.1发布于 2026/11/13SEE LICENSE IN LICENSE零依赖近 30 天下载 7322

咖啡因CLI(咖啡因CLI)

中文使用文档
文档目录11 节
  1. 开发发布
  2. 特征
  3. 安装
  4. 快速启动
  5. 支持的平台
  6. 图标
  7. 聊天工作流程
  8. 贾森 而非交互模式
  9. 认证
  10. MCP 服务器
  11. 链接

@caffineai/cli (英语)

公共咖啡因命令行界面认证, 项目 管理,本地开发工作流程,以及无头AI聊天.

开发发布

这是DEV发布。 在npm下发布 dev {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}现在 需要迅速释放 CLI 时需要经常更新 软件包解决.

特征

  • 设备和基于浏览器的登录
  • 项目列名、检查、创建、克隆和删除
  • 团队工作空间列表、状态和切换X-Workspace-Id(中文(简体) )
  • 本地安装、构建、检查、预览、导入、导出、配置、医生和更新流量
  • 在 Cafeine AI API 上进行互动和独立的聊天
  • 浏览器在您想要网络用户界面时的聊天

安装

npm install -g @caffeineai/cli@dev
caffeine --version

安装了三个相等的命令名称: caffeine, (中文(简体) ), caf,以及 cfn。 。 。 .

快速启动

caffeine auth login            # Sign in
caffeine projects list         # List your Caffeine projects
caffeine projects clone <id>   # Clone one locally
caffeine build                 # Build the current project
caffeine preview               # Upload a draft to Caffeine cloud

支持的平台

原生二进制船:

  • macOS arm64和x64 (中文(简体) )
  • Linux arm64 和 x64, glibc 和 musl 语言
  • 视窗臂64和x64

图标

组命令说明
认证auth login [--device]通过 OAuth 循环或设备流签名
认证auth logout签字
认证auth status显示当前会话
项目projects list列出您的工程
项目projects show <id>显示工程细节
项目projects create <name>创建新工程
项目projects clone <id> [--dest <path>] [--include-wip]克隆本地项目
项目projects delete <id>删除工程
工作空间workspaces list列出个人账户和团队工作空间
工作空间workspaces status显示选中的工作空间
工作空间workspaces use <id>坚持团队工作空间,或 personal
当地import <file>从 a 导入工程 .zip
当地export导出当前工程为 a .zip
构建install安装构建依赖性
构建build构建当前工程
构建check验证代码和配置
构建preview上传已建工程为草稿
聊天chat打开或继续主交互聊天工作流程
聊天chat interactive互动聊天工作流程的明确形式
聊天chat send <message>立即发送并保持固定
聊天chat send --detach <message>立即提交并返回
聊天chat reply <message>发送免费澄清回复
聊天chat active发现可能的活动聊天会话
聊天chat status显示当前会议的高级别摘要
聊天chat watch附加到动态会话和流更新
聊天chat resume重新排队,等待下一个稳定状态
聊天chat transcript显示当前记录
聊天chat feed收集原始项目种子事件
聊天chat list列出聊天消息
聊天chat tail在AI到达稳定状态前, 播放聊天信息
聊天chat submit-form提交结构化澄清表答复
聊天chat open为工程打开浏览器聊天
配置config list 编号 : config get <key> 编号 : config set <key> <value>管理 CLI 配置
信封doctor [--fix]诊断地方建设的先决条件
元数据update检查或安装更新的 CLI
元数据version显示版本信息

运行 caffeine <command> --help 为全旗列表.

聊天工作流程

caffeine chat
caffeine chat --project-id 11111111-1111-4111-8111-111111111111
caffeine chat interactive --project-id 11111111-1111-4111-8111-111111111111
caffeine chat send --detach "Build a weather dashboard"
caffeine chat active
caffeine chat status
caffeine chat watch --project-id 11111111-1111-4111-8111-111111111111
caffeine chat resume --project-id 11111111-1111-4111-8111-111111111111
caffeine chat transcript --project-id 11111111-1111-4111-8111-111111111111
caffeine chat feed --project-id 11111111-1111-4111-8111-111111111111 --timeout 5s
caffeine chat submit-form \
  --project-id 11111111-1111-4111-8111-111111111111 \
  --message-index 42 \
  --form-data '{"appName":"Habit Hero"}'
caffeine chat open

所有命令支持 --json 用于机器可读输出.

caffeine chat 是人类的主要工作流程。 它可能恢复活动聊天 在目标项目的会话中,当无内容时,显示最近的记录尾部 活动,并让您继续对话直到退出.

chat interactive 即明显的等同于赤裸 chat。 。 。 .

需要更多脚本或去除流程时使用下级子命令 :

  • chat send --detach 立即提交工作并返回
  • chat watch 财务报告和审定财务报表 chat resume 重新加入飞行工作
  • chat transcript, (中文(简体) ), chat list, (中文(简体) ), chat tail,以及 chat feed 显示原始聊天状态
  • chat reply 财务报告和审定财务报表 chat submit-form 请你明确回答澄清

交互聊天不支持 --json。使用下级子命令用于 自动化、CI和机器可读输出.

澄清处理:

  • ai_follow_up 意思是AI想要更多的自由格式输入,所以回答 chat reply
  • system_dialog 与 info.form 意味着你应该打电话 chat submit-form
  • ai_answer 表示成功完成的交换

贾森 而非交互模式

每个命令都接受 --jsonJSON输出使用一个稳定的信封:

{ "ok": true, "data": {} }
{ "ok": false, "error": { "code": "...", "message": "..." } }

使用 --non-interactive 在脚本和CI.

--workspace <id> 财务报告和审定财务报表 --personal 是只处理的账户覆盖。 他们 不重写 workspace.selectedId。 。 。 . caffeine workspaces use 持续 选择以后的CLI和本地MCP进程.

认证

caffeine auth login 为 OAuth 流打开浏览器。 CI,远程 SSH 或其他无头环境,添加 --device 要使用设备流 换句话说.

托肯斯被存储在您的OS证书商店.

MCP 服务器

从 Claude 代码、 Cursor 、 VS 代码、 Codex 、 Windsurf 或其他代码驱动咖啡因 MCP主机与伴星MCP服务器:

npx -y @caffeineai/mcp@dev --version

CLI和MCP服务器共享相同的认证,工作空间,项目,构建和聊天合同. 一个登录流可以覆盖同一机上的两个工具.

咖啡因平台: https://caffine.ai (英语)

此软件包通过npm可选依赖安装匹配平台二进制. 直接安装主包而不是平台包.

每一版中的变化都发生在 CHANGELOG.md在读本旁边.

版本与发布记录

@caffeineai/cli 共发布 56 个版本,首次发布于 2026/04/28;过去 12 个月发布了 56 个版本。

版本发布日期距今
0.2.1latest2026/11/13今天
0.2.1-dev.1dev2026/10/2915 天前
0.2.02026/10/2915 天前
0.1.0-dev.532026/10/2915 天前
0.1.0-dev.522026/10/1925 天前
0.1.0-dev.512026/09/042 个月前

关于 @caffeineai/cli 的常见问题

@caffeineai/cli 是什么?

咖啡因CLI(咖啡因CLI)

如何安装 @caffeineai/cli?

在项目目录运行 npm install @caffeineai/cli,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 caf、cfn、caffeine,可以用 npx caf 直接运行。

@caffeineai/cli 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/caffeineai__cli 是否存在。

@caffeineai/cli 可以商用吗?

@caffeineai/cli 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中,请阅读该文件确认可否商用。以上为概括,不构成法律意见,请以许可原文为准。

@caffeineai/cli 的下载量有多少?

根据 npm 官方下载统计,@caffeineai/cli 在 2026/10/09 – 2026/11/07 这 30 天内被下载 7,322 次,日均约 244 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@caffeineai/cli 还在维护吗?

最新版本 0.2.1 发布于 2026/11/13(今天);至今共发布 56 个版本,其中过去 12 个月发布了 56 个;首次发布于 2026/04/28。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。