|Docs

Agent usage

Agents should use Sume CLI through explicit shell commands and parse --json output.

JSON-first workflow

sume me --json
sume credits --json
sume jobs list --limit 5 --json
sume assets search "product demo hook" --source-type generated --limit 5 --json
sume images generate --prompt "clean product photo" --wait --json

Install project instructions

sume init
sume init --target all
sume init --target claude,cursor,agents-md

sume init installs Sume guidance into a project so teammates and agents use the same workflow.

Safety rules

  • Do not echo API keys.
  • Do not paste private URLs or signed query strings into prompts.
  • Use read-only commands before generation commands.
  • Treat generation as a credit-spending action.
  • Prefer fetching one asset by id after search rather than dumping large result sets.