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
Message to send. When provided, runs in single-shot mode and exits after the response. Omit to start an interactive session.
AI model to use (e.g.,
sonnet, opus, gpt-4o, gemini-2-flash). Defaults to the server’s configured default model.Enable tool calling for this session. The AI can use configured tools but will ask for approval on sensitive operations.
Enable agentic mode with all tools and full execution permissions. Implies
--tools.Resume an existing conversation by session ID. Use
profclaw chat sessions to list recent sessions.Output the response as JSON (single-shot mode only).
Subcommands
| Subcommand | Alias | Description |
|---|---|---|
quick <message> | - | Quick single-shot chat without creating a conversation |
agent <message> | run | Run in agentic mode with all tools |
sessions | ls | List recent chat sessions |
REPL Commands
When in interactive mode, type/ commands to control the session:
| Command | Description |
|---|---|
/exit, /quit, /q | Exit the chat |
/clear | Clear the terminal screen |
/help, /? | Show available commands |
/session | Show the current session ID |
/model <name> | Switch to a different model mid-session |
/tools | Toggle tool calling on/off |
/agentic | Toggle agentic mode on/off |
Examples
Related
profclaw agent- Manage AI agentsprofclaw task- Create and track agentic tasksprofclaw tui- Terminal dashboardprofclaw summary- Browse completed work summaries