Agent
8 tools for multi-agent delegation, isolated sandbox execution, scheduled jobs, and skill management.
Delegation
Delegate work to other agents or profiles mid-session. The delegating agent continues with other tasks while the sub-agent runs independently.
| Tool | Parameters | Description |
|---|---|---|
delegate_task | task, context?, role? | Delegate a task to a sub-agent with an optional role (e.g. "code reviewer", "researcher"). Returns a task_id for status tracking. |
delegate_to_profile | profile, task, context? | Delegate to a named agent profile. The profile's system prompt, soul, and skill set apply to the delegated run. |
Sandbox
Sandboxes create isolated copies of your workspace for risky operations. Changes stay isolated until you explicitly promote them with a patch.
| Tool | Parameters | Description |
|---|---|---|
sandbox_create | name?, source_path? | Create a new isolated sandbox environment. Optionally copy files from a source path into it. |
sandbox_run_command | sandbox_id, command | Execute a command inside a sandbox. Output and side effects are isolated from the main environment. |
sandbox_diff | sandbox_id | Show a diff of all changes made inside the sandbox compared to the original files. |
sandbox_create_patch | sandbox_id | Generate a patch file from the sandbox diff, ready to apply to the main environment. |
sandbox_apply_patch | sandbox_id, target_path? | Apply the sandbox's changes to the main environment. This is the "promote" step of the sandbox workflow. |
sandbox_list | — | List all active sandboxes with their names, IDs, and creation times. |
Scheduler
Create and manage cron-style recurring agent jobs. Jobs run on your hardware and appear in the run history. See Scheduler for more.
| Tool | Parameters | Description |
|---|---|---|
list_scheduled_tasks | — | List all scheduled jobs with their name, cron expression, last run time, and status. |
create_scheduled_task | name, cron, task, profile? | Create a new scheduled job. Pass a cron expression (e.g. 0 9 * * 1) and the task prompt to run on schedule. |
update_scheduled_task | id, updates | Update a scheduled job's name, cron expression, task, or enabled state. |
delete_scheduled_task | id | Delete a scheduled job by ID. |
Skills
Skills are markdown knowledge documents loaded into the agent's context before each run. See Skills for the full system.
| Tool | Parameters | Description |
|---|---|---|
list_skills | — | List all available skills with their name, category, and description. |
load_skill | name | Load a specific skill into the current agent context by name. Useful for on-demand skill injection mid-run. |