Use the flowus CLI with --json for every command.
Commands
- Keyword search:
flowus --json search text "<query>" - Keyword search with full documented body:
flowus --json search text --body <search.json> - Keyword search page:
flowus --json search text "<query>" --start-cursor <cursor> --page-size <n> - Semantic search:
flowus --json search semantic "<query>" - Semantic search with options:
flowus --json search semantic "<query>" --space-id <space_id> --page-size <n> --score-threshold <n> - Semantic search with full body:
flowus --json search semantic --body <semantic-search.json>
Rules
- If authentication is unclear, use
flowus --json doctor; useflowus loginfor interactive login. - Credential precedence is
--token, thenFLOWUS_TOKEN, then the token saved byflowus login. - Do not call FlowUs V2 API with
curl. - Do not print or save bearer tokens.
- Use keyword search for exact words, titles, or known phrases.
- Use semantic search when the query describes intent or meaning instead of exact text.
- Use
--bodyfor keyword search filters, sorting, and advanced request shapes. - Semantic search does not support keyword-search filters, sorting, or
start_cursor. - Treat
ok: falseas a failed operation even if the process output is parseable JSON.