How to hand off a coding agent session to another agent

By Arun Dass · Published 1 October 2026 · Updated 2 November 2026

In Friday, the free open-source app that runs your coding agents on your own computer, a hand-off means the task moves to another agent with a record of what the first did and changed. The record is built from the session log. It can only hold what the first agent actually did.

What does the record contain?

Friday builds it from the session log, with no extra model call. It holds:

  • what the first agent was asked,
  • its last answer,
  • which files it read and what it searched for,
  • the commands it ran,
  • the list of files it changed, with the patch only if the patch is short.

The next agent starts from that record instead of from a blank prompt, so it does not have to rediscover where the first one looked.

What can the record not contain?

  • The full conversation. The next agent does not read it.
  • Reasoning the first agent never wrote down, and decisions you made in your head.
  • Anything that did not reach the log. If a change is long, you get the list of changed files, not the patch.

Two agents are two separate tools, so nothing carries over as memory. Run the next agent in the same folder so it can read the code as the first left it, and add one line yourself for any decision that matters, such as “not the session code, we ruled that out”.

When does a hand-off happen?

  • You or an agent asks for one. An agent can pass its task on with the hand_off tool.
  • A coding tool hits its usage limit. Friday moves the task to the agent best placed to finish it. It picks an agent that can carry on now, never the same tool on the same computer, and it tries another coding tool before Friday Code.

When an agent takes over work that was cut off, Friday tells it to check the code as it is now, finish or undo any half-made edit and run the tests before going on. That is an instruction to the agent. Friday does not run the tests or check that the agent followed it.

See how Claude Code and Codex usage limits differ.

How do you hand work from one agent to another?

  1. Install the free open-source app and start a session on your repository.
  2. Add both agents, for example Claude Code and Codex, each on its own plan and sign-in.
  3. Let the first agent work. Ask it to hand off, or let Friday do it when its tool reaches a usage limit.
  4. Read the next agent’s changes in the diff review before you keep them.

What should you write yourself when you hand off by hand?

Without the app, the same rule holds: pass what the next agent cannot work out alone.

  • The goal, and what “done” means.
  • What is finished and what is left.
  • Decisions made, and why.
  • The files involved and anything to watch out for.

Leave out dead ends that no longer matter, raw logs and chatter that does not change the next step.

Did the hand-off save anything when we measured it?

We measured one case, Claude Code to Codex, in the hand-off benchmark. It ran on the hosted Friday app in October 2026, not on the open-source app, so read it as a measurement of the hosted app. For how agents pass work and questions to each other, see Claude Code and Codex talking to each other.

Friday Team is the hosted version for several people in one session, by arrangement: join the beta waitlist.

Common questions

Does my hand-off work with the tools I already pay for?

Yes. Friday drives Claude Code, Codex, Cursor and the other supported tools on their own plans and sign-ins, and it does not meter them.

Does the next agent remember what the first one knew?

No. The task moves to another agent with a record of what the first did and changed: what it was asked, its last answer, the files it read, its searches and commands, and the list of changed files. A short patch comes with it, a long one does not. Reasoning that was never written down is not in it.

Does it cost anything?

No. Friday is free and MIT licensed. It runs on your own computer with no account, and sends anonymous usage counts you can turn off, never your code or prompts.

Run your next task in Friday.

Free and open source (MIT), on your own computer: the desktop app for macOS, Windows and Linux, or one command with Node.js 22.