Sub-agents
Spawn parallel AI agents for complex multi-step tasks
Foxl can spawn sub-agents — independent AI sessions that work on tasks in parallel. This lets the main agent delegate work and manage multiple operations simultaneously.
How Sub-agents Work
When the agent encounters a complex task that benefits from parallel execution, it can:
- Spawn a sub-agent with a specific task and instructions
- Monitor the sub-agent's progress
- Collect results when the sub-agent finishes
- Stop a sub-agent if needed
Up to 5 sub-agents can run concurrently.
Sub-agent Tools
| Tool | Description |
|---|---|
| sessions_spawn | Create a new sub-agent with a task prompt |
| sessions_status | Check progress of running sub-agents |
| sessions_stop | Terminate a running sub-agent |
Use Cases
Parallel Research
"Research these 3 competitors and compile a comparison"
The agent spawns 3 sub-agents, each researching one competitor simultaneously, then combines the results.
Multi-file Code Changes
"Refactor the authentication module"
The agent spawns sub-agents to work on different files in parallel — one for the login flow, one for session management, one for the API endpoints.
Background Monitoring
"Keep an eye on this deployment while I work on something else"
A sub-agent monitors a deployment in the background while the main conversation continues with other tasks.
Sub-agent Visibility
Sub-agent activity is visible in the Agent page in the sidebar. You can see:
- Active sub-agents and their tasks
- Progress status for each
- Resource usage
Sub-agents share the same tools and permissions as the main agent. They can read files, run commands, and use the browser — all with the same safety controls.
Limitations
- Maximum 5 concurrent sub-agents
- Sub-agents cannot spawn their own sub-agents
- Each sub-agent has its own context window (separate from the main conversation)
- Sub-agents are available in the desktop app only