Flomo

flomo

Use this skill on macOS to read and write flomo content.

Commands

• Read recent memos (remote API, recommended; auto-expands time window):

python3 scripts/flomo_tool.py read --remote --limit 20

• Search recent memos by keyword (remote API):

python3 scripts/flomo_tool.py read --remote --limit 100 --query "关键词"

• Read by tag (recommended for diary/book/etc):

python3 scripts/flomo_tool.py read --remote --limit 10 --tag "日记"

• List top tags (to see how many memos each tag has):

python3 scripts/flomo_tool.py read --dump-tags --limit 20

• Write memo (auto-resolve incoming webhook from local flomo login state):

python3 scripts/flomo_tool.py write --content "内容"

• Write memo via URL scheme (opens flomo app draft):

python3 scripts/flomo_tool.py write --content "内容" --url-scheme

• One-shot health check (read + write-url-scheme dry flow):

python3 scripts/flomo_tool.py verify --try-webhook --query "#openclaw"

Behavior Rules

• Prefer webhook write; script can auto-resolve webhook when logged in on this Mac.
• Use URL scheme write only as fallback, because it requires GUI interaction to confirm/save.
• Read path uses remote API first and can auto-expand search window for sparse tags/keywords.
• For tag intent, prefer --tag; --query "#标签" is also supported.
• Never print full webhook URL in logs; only print masked form.