安装
需要 Node.js 22 或更新版本。全局安装即可获得 ceum 命令:
npm install -g @ceum/cli
或无需安装,直接运行一次:
npx @ceum/cli --help
开始设置
从安装到第一条命令,不到一分钟。
安装 CLI
使用 npm 全局安装该软件包(需要 Node.js 22 或更新版本)。
npm install -g @ceum/cli登录
运行登录命令,并在提示时粘贴你的令牌。它会安全地存储在你的配置中。
ceum auth login验证
确认连接是否成功——这会打印当前的配置文件和端点。
ceum auth status
基本用法
每个资源都遵循相同的名词优先语法,可输出为表格、JSON 或 CSV,随时用于管道。
列出未完成的任务,并用 jq 提取它们的标题:
ceum tasks list --status open -o json | jq '.[].title'
一行命令创建一个任务:
ceum tasks create --title "Ship v1" --status todo
将每笔交易导出为 CSV:
ceum transactions list --all -o csv > all-transactions.csv
在 CI 中使用来自环境变量的令牌无头运行:
CEUM_TOKEN=ceum_… ceum invoices list
你的工作区,从命令提示符开始
与网页和移动应用相同的工作区,由可预测的命令语法驱动。
名词优先的命令
可预测的语法——task list、time start、invoice new——用于驱动你的工作区。
为脚本而生
以非交互方式运行命令,把 Ceum 接入你现有的自动化流程。
按你的方式输出
以表格、JSON 或 CSV 形式获取结果,随时可管道传入下一个工具。
批量操作
一次性操作多条记录,无需逐条点击处理。
底层由 MCP 驱动
该命令行工具是一个轻量客户端,基于 Ceum 向外部工具开放的 Model Context Protocol。
助手就绪
同样的操作也驱动着应用内的助手,因此编写脚本与直接询问共用同一套接口。
触及整个工作区
客户、项目、任务、时间、交易和发票——全部都能从命令行访问。
带文档的命令
每条命令都内置帮助,知识库中还提供完整参考。