CLI 文档

本文是 nilo CLI 的使用入口。具体命令已经按主题拆分到下方分册，避免把 page、block、database、配置和高级入口混在同一个文件里。

先读

• Installation：安装 nilo。
• Uninstallation：卸载命令行工具、清理 MCP client 配置、本地 token 和项目上下文。
• Configuration：准备 Notion connection、设置 token、创建项目级上下文。
• MCP Clients：在 MCP 工具里配置 N.I.L.O. 本地 MCP server。
• Troubleshooting：常见错误和排查入口。

CLI 分册

• Overview：通用规则、JSON 参数、--dry-run 和命令别名。
• Project Config：init、pwd、version 和 config --global/--local。
• Page：绑定默认 page、读取 page、读取 blocks、创建和更新 page。
• Block：append、insert-after、update、trash 等 block 操作。
• Database DataSource：database 容器、data source 表级操作和 database 快捷命令。
• Auth And User：token 校验、whoami 和 user 查询。
• Comments：读取、创建和回复 comments。
• Views：读取、列出、查询、创建和更新 views。
• File Uploads：file upload 生命周期命令。
• Search And Custom Emoji：workspace 搜索和 custom emoji。
• Raw API：高级兜底 Raw API 入口。
• MCP Server：启动、停止、查看状态和日志。

常用起步顺序

nilo config --global user.token ntn_xxx
nilo config --global --show
nilo init --project-name "Demo"
nilo page attach <page_id>
nilo page retrieve
nilo page blocks