@postonus / cli
从你的终端安排和发布社交帖子。
npm install -g @postonus/cli
postonus login
postonus post "shipping today" --to x,linkedin --optimal
需要Node.js 22.12或更新版本。需要一个 Postonus 帐户。
不安装运行： npx @postonus/cli whoami
命令
| 命令 | 它是做什么的 |
|---|---|
login / logout / whoami | 浏览器批准的登录，以及您的身份 |
channels list | 连接的通道及其健康状况 |
channels connect | 通过OAuth连接一个新通道 |
post <text> | 安排一个帖子（从不立即发布） |
queue list | 即将安排的职位 |
queue move <scheduleId> --at | 重新安排一个排队的帖子 |
media upload <path…> | 上传图片或视频用于帖子 |
best-times --to <platforms> | 推荐投寄窗口 |
postonus <command> --help 他们身上的旗帜。
调度帖子
postonus post "shipping today" --to x,linkedin --optimal
postonus post --file draft.md --to linkedin --at 2026-08-01T09:30:00Z
postonus post --editor --to x --draft
postonus post "with a video" --to x --media ./demo.mp4 --optimal
cat draft.md | postonus post --to x --optimal
post 总是安排;它从不当场发表。选择一个时间
--at <ISO timestamp> 或者 --optimal 对于下一个推荐窗口，或使用
--draft 没有时间的节省。 --dry-run 显示会发生什么，然后停止。
脚本
每个命令都需要 --json，它在标准输出和
跳过所有交互渲染：
postonus queue list --json | jq -r '.queue[] | "\(.scheduledAt) \(.platform)"'
postonus post --file draft.md --to linkedin --at 2026-08-01T09:30:00Z --json
数据输出到标准输出，进度输出到标准输出，错误输出到标准输出，因此管道保持干净。退出
代码是 0 成功, 1 失败, 2 使用错误。没有TTY， CLI永远不会
提示-传递标志，并使用 --no-input 把丢失的一个变成一个
宁可犯错也不要等待。
CI
集 POSTONUS_API_KEY 到仪表板上的API密钥。它优先于
存储会话，所以不是 login 步骤：
- run: npx @postonus/cli post "$MESSAGE" --to x --optimal
env:
POSTONUS_API_KEY: ${{ secrets.POSTONUS_API_KEY }}
环境
| 变量 | 目的 |
|---|---|
POSTONUS_API_KEY | 非交互使用的API密钥；覆盖 login |
POSTONUS_API_URL | 与之交谈的仪表盘；默认为生产 |
EDITOR/VISUAL | 编辑器由 post --editor |
NO_COLOR | 禁用彩色输出 |
XDG_CONFIG_HOME | 会话存储的位置；默认为 ~/.config |
postonus logout 删除存储的凭据。