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