Writeathon CLI

用于通过命令行把内容保存到 Writeathon，并支持查询卡片、空间、写作拾贝和上传图片。

安装

npm install -g @buertang/writeathon-cli

安装 Agent Skills

如果你在 Codex、Claude Code 或其他支持 Agent Skills 的环境中使用，可以额外安装 Skills：

npx skills add buertang/writeathon-cli -y -g

安装后检查：

writeathon version
writeathon help

登录

writeathon auth login --token YOUR_TOKEN

也可以使用环境变量：

export WRITEATHON_TOKEN="YOUR_TOKEN"

Windows PowerShell：

$env:WRITEATHON_TOKEN="YOUR_TOKEN"

常用命令

查看当前用户：

writeathon auth me

创建卡片：

writeathon card create --title "标题" --content "内容"

从文件创建卡片：

writeathon card create --title "标题" --file note.md

扩展卡片：

writeathon card extend --parent CARD_ID --title "扩展标题" --content "扩展内容"

最近卡片：

writeathon card recent

获取卡片：

writeathon card get --id CARD_ID
writeathon card get --title "标题"

搜索卡片：

writeathon card search "关键词" --limit 10

空间列表：

writeathon space list

写作拾贝：

writeathon pick --type all --limit 10
writeathon pick --type card --limit 5
writeathon pick --type page --limit 5

上传图片：

writeathon upload image.png
writeathon upload image.png --no-wait
writeathon upload result TASK_ID

指定空间

先获取空间 ID：

writeathon --json space list

再写入指定空间：

writeathon card create --space SPACE_ID --title "标题" --content "内容"
writeathon card recent --space SPACE_ID
writeathon card search "关键词" --space SPACE_ID --limit 10

JSON 输出

需要给脚本或 Agent 解析时，加 --json：

writeathon --json card recent
writeathon --json card search "关键词" --limit 10
writeathon --json upload image.png