Memos
Use flowbot memo for capability memos.
CLI root is memo — do not invent flowbot memos unless cli.md lists it as an alias.
Prefer the workflows below; load references/cli.md only when you need a flag or subcommand not covered here.
JSON fields: Memo resource name (not a numeric id) is the get/delete argument; see name in -o json.
Setup
- Ensure CLI auth:
flowbot login - Set server via
FLOWBOT_SERVER_URLor--server-url; optional--profile,--debug/-d - Prefer
-o jsonwhen parsing results programmatically - Destructive commands often need
-y/--yesin non-interactive sessions — check cli.md - Token scopes:
service:memos:read/service:memos:write
Workflows
Capture a quick note
When a user wants to save a short memo:
flowbot memo create -c "<content>"- Report back with the memo name.
Review recent memos
When a user wants to browse or open memos:
flowbot memo list --limit 20flowbot memo get <name>- Present the memo content to the user.
Troubleshooting
| Error | Fix |
|---|---|
| not logged in | flowbot login |
| server URL is required | set FLOWBOT_SERVER_URL or pass --server-url |
| permission denied / 403 | token missing service scopes (service:memos:read / service:memos:write) |
| hung waiting for confirm | pass -y when the command supports it (see cli.md) |
| empty results | provider not configured, wrong id/name, or empty dataset |
| unknown command | use flowbot memo, not the capability id as the CLI verb |