harbor

Run Jobs

Trial Handoff

Resume a finished trial's agent session in your local agent CLI

harbor trial handoff is the opposite side of loading trajectories: instead of seeding a past session into a container, it takes the session out of a finished trial so you can continue the conversation on your own machine, and ask the agent what it did, why it took an approach, or what it would try next.

# a local trial directory
harbor trial handoff jobs/<job>/<trial>

# or a trial ID, downloaded from the Harbor platform first
harbor trial handoff 594025f3-7d65-4655-8576-4bee95002eae

Harbor copies the trial's native session into the local agent CLI's session store for your current directory, then replaces itself with the resumed session. For claude-code that means you land directly in claude --resume <session-id>, talking to the agent with its full trial conversation as context.

Requirements

  • The trial was run by an agent with handoff support (SUPPORTS_HANDOFF); today that is claude-code.
  • The agent CLI is installed locally (claude on PATH). If you are not logged in, the CLI's own login flow takes over on launch.
  • The trial has exactly one session; multi-session trials (e.g. multi-step tasks with fresh per-step sessions) are rejected.

What is restored

Only the conversation, the same rule as loading: the agent remembers everything it said and did, but files it created in the container do not exist on your machine, so it can discuss its work, not re-open it.

On this page