旋转 CLI
Twist 的命令行界面 .
安装
npm install -g @doist/twist-cli
代理技能
为您的编码代理安装技能 :
tw skill install claude-code
tw skill install codex
tw skill install cursor
tw skill install gemini
tw skill install pi
tw skill install universal
技能安装到 ~/<agent-dir>/skills/twist-cli/SKILL.md (例如:. ~/.claude/ 为克来德码, ~/.agents/ (为普世等). 在更新CLI时,所安装的技能会被自动更新. 这个 universal 代理与 Amp 、 OpenCode 和其他从 ~/.agents/。 。 。 .
tw skill list
tw skill uninstall <agent>
卸载
首先,删除任何已安装的代理技能:
tw skill uninstall <agent>
然后解开CLI:
npm uninstall -g @doist/twist-cli
本地设置
git clone https://github.com/todoist/twist-cli.git
cd twist-cli
npm install
npm run build
npm link
这使得 tw 命令可在全球范围使用.
设置
tw auth login
此打开您的浏览器以认证 Twist 。 一旦批准,该令牌存储在您的OS证书管理器中:
- macOS: 键链
- 窗口: 证书管理器
- Linux: 特务/libsecret
如果无法安全存储,则CLI会发出警告并返回到 ~/.config/twist-cli/config.json。在下次 CLI 从配置文件中成功读取时, 将自动移出已有的纯文本符号 。 诸如当前工作空间等非秘密设置仍然保留在配置文件中 .
替代方法
手动符号 :
tw auth token "your-token"
环境变量:
export TWIST_API_TOKEN="your-token"
TWIST_API_TOKEN 总是优先于存储的符号.
Auth 命令
tw auth status # check if authenticated
tw auth logout # remove saved token
使用量
tw inbox # inbox threads
tw inbox --unread # unread threads only
tw mentions # content mentioning you
tw mentions --since 2026-04-01 --all --json
tw thread view <ref> # view thread with comments
tw thread view <ref> --comment 123 # view a specific comment
tw thread reply <ref> # reply to a thread
tw thread rename <ref> "New title" # rename a thread
tw thread update <ref> "New body" # edit a thread's body (first post)
tw conversation unread # list unread conversations
tw conversation view <ref> # view conversation messages
tw msg view <ref> # view a conversation message
tw search "keyword" # search across workspace
tw search "keyword" --all # fetch all result pages
tw react thread <ref> 👍 # add reaction
tw away # show away status
tw away set vacation 2026-03-20 # set away until date
tw away clear # clear away status
tw groups # list groups in a workspace
tw groups view <ref> # show a group with members
tw groups create "Frontend" # create a group
tw groups create "FE" --users [email protected],[email protected]
tw groups rename <ref> "New name" # rename a group
tw groups delete <ref> --yes # delete a group
tw groups add-user <ref> [email protected] [email protected]
tw groups remove-user <ref> id:123,id:456
参考文献 接受身份证123 或者说 id:123),twist URL,或模糊名称(用于工作空间/用户).
运行 tw --help 或者说 tw <command> --help 更多选择.
贝壳补全
标签完成可以提供:
tw completion install # prompts for shell
tw completion install bash # or: zsh, fish
重新启动您的 shell 或源代码您的配置文件以激活 。 要删除 :
tw completion uninstall
机器可读输出
所有列表/视图命令支持 --json 财务报告和审定财务报表 --ndjson 用于脚本的旗帜 :
tw inbox --json # JSON array
tw inbox --ndjson # newline-delimited JSON
tw inbox --json --full # include all fields
发展
npm install
npm run build # compile
npm run dev # watch mode
npm run type-check # type check
npm run format # format code
npm test # run tests