clawdbot/docs/agent-send.md

summary, read_when

summary	read_when
Design notes for a direct `clawdis agent` CLI subcommand without WhatsApp delivery	Adding or modifying the agent CLI entrypoint

clawdis agent (direct-to-agent invocation)

clawdis agent lets you talk to the embedded agent runtime directly (no chat send unless you opt in), while reusing the same session store and thinking/verbose persistence as inbound auto-replies.

Behavior

• Required: --message <text>
• Session selection:
  • If --session-id is given, reuse it.
  • Else if --to <e164> is given, derive the session key from session.scope (direct chats collapse to session.mainKey).
• Runs the embedded Pi agent (configured via agent).
• Thinking/verbose:
  • Flags --thinking <off|minimal|low|medium|high> and --verbose <on|off> persist into the session store.
• Output:
  • Default: prints text (and MEDIA:<url> lines) to stdout.
  • --json: prints structured payloads + meta.
• Optional: --deliver sends the reply back to the selected provider (requires --to for WhatsApp).