Lime CLI

在本地项目中工作

Lime CLI/TUI 可以读取和编辑工作目录中的文件，运行本机已安装的工具。交互 TUI 适合持续协作，非交互执行适合脚本与重复流程。

CLI/TUI 与桌面使用同一任务执行链，终端安装包不包含 Electron 界面。使用前确认当前目录、模型与权限。

开始使用 Lime CLI

安装

需要 Node.js 18 或更新版本。安装官方包并核对版本：

npm install -g @limecloud/lime
lime --version

当前载荷覆盖 macOS arm64/x64、Windows x64 与 Linux x64 GNU。安装失败时先检查系统架构、Node 与 npm 错误。

启动与连接模型

在项目目录中运行交互界面，配置可用模型服务并检查连接。Lime 不依赖其他产品账号的套餐权益。

lime
# 也可以显式启动 TUI
lime tui

完成第一个任务

先讲解这个项目的入口和测试方式，不要修改文件。

需要修改时，先检查已有未提交变更；完成后检查差异和相关测试。不要为了保存检查点自动提交用户的更改。

与脚本和自动化集成

lime exec "检查当前项目的变更并报告风险"
lime exec --json "检查当前项目的变更并报告风险"

非交互任务应有清晰的输入、输出和失败处理。机器可读输出也要检查任务终态与实际结果；不要只根据命令启动成功判断业务完成。

在终端中完成编码工作

在同一任务中调查问题、制定计划、编辑文件并运行项目工具。后续消息可收窄范围、补充错误或要求解释依据。

使用技能与工具

通过可用技能复用工作方法，使用 MCP 连接本地或远程工具。先检查凭据、工具列表与实际连接状态。

审查改动

使用当前 CLI 提供的审阅能力检查未提交变更、提交或基准差异。明确只审查还是允许修复，并检查发现的问题能否复现。

围绕终端构建工作流

继续已保存任务

使用 lime resume 恢复任务；具体选择与参数以 lime resume --help 为准。恢复后先核对目录和当前文件状态。

补充图像与外部信息

报错截图、设计参考与网页资料可以补充任务上下文，但需确认当前终端入口和模型支持的输入方式。最新信息要核对原始来源。

拆分调查

复杂任务可让主智能体分配独立子任务并汇总结果。明确文件归属、可修改范围和最终验收，避免同时改同一文件。

设定权限

选择允许的文件、命令和网络范围。工具策略、系统权限与运行环境是不同边界，不能相互替代。

按终端习惯配置

通过当前版本的帮助和配置入口了解快捷键、主题和命令；不要复制其他产品的命令清单。

连接远端运行环境

需要远端运行时，通过安全 WebSocket 连接实际部署的 App Server，并从环境变量读取令牌。远端目录、模型和工具单独检查。

lime exec \
  --remote wss://<远端服务地址>/rpc \
  --remote-auth-token-env LIME_REMOTE_TOKEN \
  "检查远端项目并报告当前状态"

选择其他入口

需要可视化文件、浏览器和桌面工作区时，使用 Lime 桌面应用。终端中的模型与工具并不自动具有桌面宿主能力。