Resuming and handoff

Picture a team working together. One member does some work, then hands it off to another. Today, people serialize that into a handoff file: check out this branch, read this markdown. That is a description of the work, not the work itself.

Polygraph captures the state of the world along with it. Resuming isn't a copy-paste into the agent's memory. It is a time machine that drops you exactly where the original author stopped. The agent can inspect the repos, follow the pull requests and issues, and run commands with the old context available.

This applies to any work done by anyone in the organization, no matter how cross-cutting. Every session feeds one shared memory, so your agent builds on what the whole team did.

Resume a session

Resume a session when you want to continue the same work. You can resume a session you created or a session someone else handed to you.

polygraph session resume <session-id>

You can omit the ID and select a session from the list:

polygraph session resume

When you resume, Polygraph reconstructs the session state as closely as possible: the repos are set up at the relevant SHAs, along with the branches, agent traces, and the relevant agent context.

Hand off across machines, people, and agents

A handoff is a resume done by someone else. Share the session ID or URL, and a teammate picks up exactly where you stopped, on their machine, with the full context of what you did and why.

Resuming works across machines, operating systems, and AI agents. You can start the work on one machine and continue on another, or start the work using Claude and finish it using Codex, without any friction.