CLI 功能使用指南

过去，当你让 AI 帮忙写一篇文章时，通常还要经历复制正文、打开写作软件、新建文稿、粘贴内容等步骤。Loby CLI 把这段重复操作缩短成一句话：

请写一篇关于个人知识管理的文章，完成后放到落笔收件箱。

Codex 完成写作后，会通过 Loby CLI 创建一份标准 Markdown 文稿。它会直接出现在落笔的收件箱中，接下来你可以像处理自己创建的文稿一样，继续修改、整理或移动到项目。

Loby CLI 是什么？

CLI 是“命令行工具”的缩写。你不需要为了使用它去学习终端命令，可以把它理解成落笔提供给 AI Agent 的一个安全入口。

在这套协作关系中：

• Codex 负责理解你的要求、撰写或整理正文；
• Loby CLI 负责找到正确的写作库，并创建或修改指定文稿；
• 落笔负责显示、编辑、整理和长期保存文稿；
• Codex Skill 告诉 Agent 应该在什么情况下调用 CLI，以及哪些边界不能越过。

CLI 和 Skill 不是两套重复功能。CLI 负责真正的文件操作，Skill 负责教 Codex 正确使用这项能力。

开始之前

使用 Loby CLI 需要：

1. 已安装落笔桌面应用，并至少成功打开过一次写作库；
2. 电脑已安装 Node.js 20 或更高版本；
3. 可以使用 npm 安装 loby-cli；
4. 使用 Codex 作为 AI Agent。

Loby CLI 已发布到 npm，可以直接使用下面的命令进行全局安装：

npm install -g loby-cli

安装完成后，检查 CLI 是否可以正常运行：

loby --version

如果终端输出版本号，说明命令已经安装成功。注意，--version 使用的是两个短横线，不是一个长破折号。

再安装配套的 Codex Skill：

loby skill install codex

安装 CLI 和 Skill 通常只需要执行一次。以后更新 CLI 时重新运行 npm 安装命令；更新 Skill 时运行：

loby skill install codex --force

检查是否配置成功

安装完成后运行：

loby doctor --json

如果结果中的 ok 为 true，说明 CLI 已经找到当前写作库、确认收件箱可写，并检测到了 Codex Skill。

普通使用时，你不需要记住写作库路径。落笔桌面端会记录最后成功打开的写作库，CLI 会优先使用它。

如果电脑上有多个写作库，可以先查看当前目标：

loby library current --json

桌面端记录不可用时，也可以手动指定默认写作库：

loby library use "/你的/落笔写作库路径"

最简单的使用方式

配置完成后，直接在 Codex 中说明“写什么”和“放到落笔”即可。例如：

帮我写一份本周工作复盘，包含完成事项、遇到的问题和下周计划，完成后放到落笔收件箱。

把我们刚才讨论的产品方案整理成一份 Markdown 文档，标题叫《Agent 写作工作流》，保存到落笔。

根据这些资料起草一篇文章，不要直接发布，只创建到落笔收件箱，我之后自己修改。

Codex 会先检查 CLI 状态，再准备完整正文。只有收到包含文稿路径和文稿 ID 的成功回执后，它才会告诉你文稿已经创建。

已有 Markdown 文件时

如果正文已经保存在本地文件中，可以让 CLI 直接导入收件箱：

loby inbox create \
  --title "文章标题" \
  --file "/absolute/path/article.md" \
  --json

CLI 会为文稿补充落笔需要的稳定 ID、创建时间和收件箱信息，但不会覆盖正文内容。

让 Codex 继续修改文稿

只要明确告诉 Codex 要修改哪一篇文稿以及具体要求，它就可以通过 CLI 直接替换正文。例如：

把刚才创建到落笔的文章重新整理一下，缩短开头，并增加一个常见问题章节。

修改这篇落笔文稿，把第二部分改成更适合普通用户阅读的表达。

Codex 可以使用创建回执中的文稿 ID：

loby document update \
  --id "sheet-..." \
  --file "/absolute/path/revised.md" \
  --json

也可以使用 CLI 回执中的文稿绝对路径：

loby document update \
  --path "/absolute/path/document.md" \
  --file "/absolute/path/revised.md" \
  --json

修改会立即生效，不需要再次确认。CLI 只替换正文，原来的标题、文件名、标签、自定义属性和项目归属都会保留。

它会自动处理什么？

每次创建新稿时，Loby CLI 会：

• 自动找到当前活动写作库；
• 把文稿创建到收件箱；
• 生成与落笔桌面端一致的稳定文稿 ID；
• 写入标准 Markdown frontmatter；
• 继承收件箱的默认目标字数；
• 遇到同名文稿时自动增加数字后缀；
• 使用排他创建，保证不会覆盖已有文件。

如果落笔正在运行，文件监听会让新稿很快出现在收件箱；如果落笔没有运行，下次启动时也会从 Markdown 文件中恢复出来。

功能边界

Loby CLI 当前聚焦于两件事：创建收件箱新稿，以及直接修改指定文稿正文。

它不会：

• 擅自移动文稿到项目；
• 修改落笔内部索引；
• 自动发布文章；
• 删除本地文件；
• 给文稿设置“构思”“完成”等已经取消的状态；
• 根据相似标题猜测要修改哪一篇文稿。

创建新稿时，CLI 永远不会覆盖同名文件。修改文稿时，则必须使用稳定文稿 ID 或 CLI 返回的绝对路径精确定位。修改采用“最后一次写入生效”，因此同一篇文稿正在落笔中编辑时，最好先完成当前编辑，再让 Agent 修改。

常见问题

为什么 loby --version 没有输出版本号？

先确认已经安装 Node.js 20 或更高版本，然后重新执行：

npm install -g loby-cli

安装完成后，再运行：

loby --version

如果终端提示找不到 loby 命令，通常需要检查 npm 的全局安装路径是否已经加入系统的 PATH 环境变量。

为什么新稿没有出现在收件箱？

先运行 loby doctor --json，检查 ok 是否为 true，以及其中显示的写作库路径是不是你当前使用的写作库。必要时重新打开目标写作库，再执行一次检查。

为什么提示没有安装 Skill？

运行：

loby skill install codex

如果是在更新已有 Skill，需要明确允许覆盖：

loby skill install codex --force

同名文章会被覆盖吗？

不会。假设收件箱中已经有 每周复盘.md，再次创建时会生成 每周复盘 2.md，原文件保持不变。

能让 Codex 继续修改已经存在的文稿吗？

可以。明确告诉 Codex 要修改的文稿和修改要求即可。CLI 会通过文稿 ID 或绝对路径找到目标，并直接替换正文，不显示提案或确认步骤。标题、标签、自定义属性、项目归属和文件名不会改变。

一句话记住它

以后当你希望 Codex 的写作结果进入落笔，只需要在要求末尾加一句：

完成后放到落笔收件箱。

剩下的路径发现、文稿身份、文件命名和安全写入，都交给 Loby CLI。

如果想继续修改，也只需要接着说：

把刚才那篇落笔文稿再改一下。