Skip to main content

Synopsis

Description

chat connects to the profClaw API and starts a conversation with the AI. When called without a message it enters an interactive REPL with session persistence. When called with a message it runs in single-shot mode and exits. Two execution modes are available:
  • Chat mode (default) - conversational, no tools
  • Agentic mode (--agentic) - full tool access, multi-step execution

Flags

string
Message to send. When provided, runs in single-shot mode and exits after the response. Omit to start an interactive session.
string
AI model to use (e.g., sonnet, opus, gpt-4o, gemini-2-flash). Defaults to the server’s configured default model.
boolean
Enable tool calling for this session. The AI can use configured tools but will ask for approval on sensitive operations.
boolean
Enable agentic mode with all tools and full execution permissions. Implies --tools.
string
Resume an existing conversation by session ID. Use profclaw chat sessions to list recent sessions.
boolean
Output the response as JSON (single-shot mode only).

Subcommands

REPL Commands

When in interactive mode, type / commands to control the session:

Examples