Agent

Tools the agent uses to hand off work, try risky changes in a copy, look after Cats, and load skills.

Delegation

Hand part of a task to another agent. A helper works in its own context and returns a short result, so big jobs don't fill up the main run.

ToolParametersDescription
delegate_task role, task, isolation?, read_only?, tools?, max_rounds? Start a helper agent with a role, such as “Code Reviewer”. isolation is auto (a copy of the project for coding tasks), copy or same_workspace. read_only keeps it to reading and searching. tools limits it to a list of tools. Up to 15 rounds by default, 30 at most.
delegate_to_profile profileHandle or profileId, task, context? Hand a task to one of your agents, usually one you mentioned with its handle. It works with that agent's instructions, working folder, step limit and pre-approved tools.

You can also mention one of your agents in any chat with #handle to hand it one message. See Agents.

Copies

A copy of the project for trying risky changes: a git worktree when the project uses git, or a plain copy of the folder. Changes stay in the copy until you review them and bring them back. A copy keeps files apart, not programs: its commands run in the command sandbox like any other. The chat's Code panel lists copies under Copies.

ToolParametersDescription
copy_createname?, sourcePath?, strategy?, baseRef?Make a copy of the project, or of a folder inside it. strategy is auto, worktree or copy.
copy_listincludeDeleted?List the copies of this project.
copy_statusidA copy's status and git summary.
copy_diffid, filePath?, includePatch?The changed files, or a unified diff, before anything comes back.
copy_run_commandid, command, cwd?, kind?, timeoutMs?Run a command inside a copy and keep its output as a job log.
copy_jobsid, limit?The commands, tests and promotions run in a copy.
copy_create_patchid, filePaths?Make a unified patch from a copy's changes.
copy_apply_patchid, filePaths?, dryRun?Bring a copy's changes back to the project. dryRun only checks that they apply cleanly.
copy_commit_branchid, message?, filePaths?Commit a copy's changes on a branch of their own, ready to push or open as a pull request.
copy_deleteid, force?Delete a copy's folder.
copy_delegate_taskid, task, maxRounds?Run a helper agent inside a copy, so its edits and commands stay out of the live project.

These tools used to be called sandboxes. The old sandbox_* names still work, so saved agents and Cats that use them keep working.

Cats

Cats are agents that work on their own. With these tools, the agent sets them up from a chat, for example when you ask “every weekday at 8am, summarise my email”. See Cats.

ToolDescription
list_catsList your Cats: their missions, what wakes them, whether they are on, their next wake and their last result.
create_catMake a Cat with a mission and at least one wake-up: a schedule in plain words or cron, or watchers for email, feeds, pages or folders. Also sets its brain, model, project, freedom, sites and pre-approved tools.
update_catChange a Cat. A new schedule replaces its timer; new watchers replace those of the same kind.
pause_cat, resume_catTurn a Cat off or back on. A run in progress finishes first, and nothing missed while it was off is made up.
wake_catWake a Cat now, outside its schedule, or stop a run in progress.
list_cat_runsA Cat's recent runs: what woke it, how each ended, and the results.
delete_catDelete a Cat, its run history and its browser sign-ins. Its chat is kept.

Making or changing a Cat is a step the agent asks about first. A Cat's own run can look at Cats but can't create, change or wake them.

Skills

Skills are Markdown instructions for a kind of work. Asyncat picks the relevant ones for each run; these tools let the agent look for more. See Skills.

ToolParametersDescription
list_skills — List every skill with its name, description and tags.
load_skill name Load a skill's full instructions by its exact name, such as systematic-debugging.