Overview
Session tools enable multi-agent orchestration. One agent can spawn a child session, send it a task, and check back on its progress - enabling parallel workstreams and specialized sub-agents. profClaw has two sets of session tools:- Sessions tools (
sessions_*) - manage conversation sessions as persistent chat threads - Session spawn tools (
spawn_session,send_message, etc.) - hierarchical agent-to-agent communication
Sessions Tools
sessions_spawn
Spawn a new chat session with an optional initial task.
Security level: moderate | Tier: Full
string
Title for the new session. Auto-generated from the task if not provided.
string
Initial task or message to send to the new session.
string
default:"profclaw-assistant"
Skill preset for the session:
profclaw-assistant, code-assistant, git-workflow, etc.string
Link this session to a project.
string
Link this session to a specific ticket for focused work.
string
default:"chat"
Session mode:
chat (conversational) or agentic (autonomous execution).object
Additional key-value metadata to attach to the session.
sessions_list
List active or recent sessions.
Security level: safe | Tier: Full
string
Filter by status:
active, idle, completed.string
Filter by project.
number
default:"20"
Maximum sessions to return.
sessions_send
Send a message to an existing session.
Security level: moderate | Tier: Full
string
required
Target session ID.
string
required
Message to send.
session_status
Get the current status and model of an active session.
Security level: safe | Tier: Full
string
Session ID. Defaults to the current session.
Hierarchical Agent Tools
These tools are used by an orchestrator agent to spawn and coordinate worker agents.spawn_session
Spawn a dedicated worker agent session.
string
required
Name for the worker session.
string
required
System-level instructions for the worker.
string
Override the AI model for this worker (useful for routing cheap tasks to smaller models).
send_message
Send a message to a spawned worker and await a response.
string
required
Worker session ID returned by
spawn_session.string
required
Task or message to send.
number
default:"300000"
Maximum time to wait for a response in milliseconds.
receive_messages
Poll for new messages from a worker session without blocking.
list_sessions
List all spawned worker sessions from the current conversation.
Multi-Agent Patterns
- Parallel Research
- Code + Review Pipeline
Spawn multiple agents to research different topics simultaneously, then synthesize:
Related Tools
profClaw Ops
Link sessions to tickets for focused work.
Memory
Share knowledge across sessions via memory files.