Agents in Code

Agent profiles and assignments#

An Agent’s profile includes its name, instructions, access limits, and skills. To edit a profile, open the Agent from the Agents list and tap its name. Profiles are shared with Chat. An assignment is work within one Code task, on this computer, with this runtime. If you sign out, your Agents aren’t available for delegation, but Code keeps working without an account.

For the Agents list, pictures, and routines, see Agents.

What an Agent uses in Code#

An Agent’s Chat model isn’t used in Code. Delegated work uses the lead task’s runtime, model, and reasoning level. The profile can still narrow the work:

• Files sets a limit: Read-only or Project write. The task’s permission can be lower than this limit, but not higher.
• Memory can follow your account, be read-only, or be off for linked Chat memory.
• Skills and connectors include everything that’s enabled and compatible, unless the profile lists specific ones.
• Instructions apply to all of the Agent’s work. Notes in the Agent’s home conversation aren’t part of the Code transcript.

Hand off part of a task#

Choose a delegation setting in Mode, permission, delegation, in the lower-left corner of the composer:

• No delegation keeps the work in the lead task.
• Manual approval adds a proposal to the Agents panel for you to accept.
• Auto is available only when the runtime supports it.

You can run one to four Agents at a time, though the runtime may allow fewer. Only one Agent can edit the project at a time. Describe what the finished work should look like and what evidence you want back. Task tools → Agents shows each Agent’s work next to the lead task.

Delegated Agents don’t commit, push, or delete on their own. You do those separately, after you review the result. See Review.

Agents on iPhone#

With the right permissions, Remote shows Agent activity, each Agent’s transcript, and approvals, and you can message or stop an Agent. Remote doesn’t start a second runtime. In an Agent’s home conversation, Open this Agent's computer opens a browser task on a computer you’ve already paired, not on a computer in the cloud.

Cursor Cloud Agents, if you’ve installed that plugin, works differently. Work runs on Cursor’s service with your Cursor account. It asks you before it dispatches work, and it doesn’t merge the pull request for you.