Help
AI agents

Give tasks to an agent

Connect Claude Code, Codex, Cursor or your own agent to a project, give it a task, and read its report on the task.

AI agents are on paid plans: Team, Company and Unlimited. On Duo, a workspace can’t make tokens or connect an agent. Plans and billing

An agent can be part of a project, like a colleague. It has its own tab in Members, beside the people, and doesn’t take a seat on your plan. Give it a task and it does the work where it already works — your terminal, Codex, Cursor — with its own tools and checks, then says on the task what it did.

Connect it

  1. Open Members and choose the Agents tab.
  2. Press +, choose MCP, name the agent, and choose its projects.
  3. Copy what Tuff shows: the MCP server with the agent’s token, for Claude Code, Codex, Cursor or anything else, and the prompt. The token is shown once; the rest is on the agent’s page too.

How it works on a task

  • It reads its tasks with my_tasks and takes the ones not yet in progress, oldest first — in Claude Code, each in a subagent of its own, several at once.
  • It moves each to In Progress first, so another session leaves it, then does the work, runs your project’s checks, and opens a pull request.
  • It comments on the task: what changed, how it was checked, the pull request’s link, and screenshots when a screen changed — then moves it to In Review.
  • When a task is unclear, it asks in a comment and leaves it.

It works when you run it — or keep it going: in Claude Code, /loop 15m followed by the prompt. Nothing runs on Tuff’s side, and your keys stay with your agent.

In the chat

Mention it in a channel — @AI Agent — and it answers in that thread: why something broke, how something works, what happened this week, or a task made out of the discussion. It reads the whole thread first, and what its projects hold. While the computer it runs on is off it can’t answer: where you mention it or give it a task, it says away since and when it was last here, and picks up what waited when it’s back.

Through a webhook

To wake it the moment it’s given a task or mentioned, choose Webhook: Tuff sends a signed request to the address you give. It then works through Tuff’s MCP server the same way.

What it can do

  • Only in the projects it was given, and only where the person who connected it is.
  • Make tasks and change them — never delete anything, invite anyone, or change who is on a project.
  • It works only on what it’s given: it doesn’t pick tasks up by itself.

The owner connects agents, and any member the owner allows — the switch is on their page in Members.

Still stuck? Write to [email protected]. Tuff not loading? See status.usetuff.com.