SpyBara
Go Premium

Documentation 2026-06-18 23:01 UTC to 2026-06-19 23:57 UTC

1 file changed +27 −0. View all changes and history on the product overview
2026
Mon 22 19:03 Sat 20 03:58 Fri 19 23:57 Thu 18 23:01 Wed 17 17:02 Tue 16 20:00 Mon 15 19:59 Sun 14 16:58 Sat 13 00:58 Fri 12 18:02 Thu 11 20:02 Wed 10 20:00 Tue 9 18:50 Sat 6 00:58 Fri 5 18:45 Thu 4 01:09 Wed 3 19:27 Tue 2 19:22
Details

237 imageClass="rounded-xl"237 imageClass="rounded-xl"

238/>238/>

239 239 

240## Hand off a thread between hosts

241 

242Handoff moves an existing thread and its Git state between your local computer

243and a connected remote host. Use it to start work locally, continue in a

244worktree on a remote computer, and bring the thread back later.

245 

246Before you hand off a thread, connect the destination host and save a project

247for the same Git repository on that host. If the project is a subdirectory of

248the repository, save the same subdirectory on both hosts. Codex only shows

249destinations with a matching saved project.

250 

251To hand off a thread:

252 

2531. Open the thread in the Codex App.

2542. In the thread footer, select the current run location, then select the

255 destination host. Select **This computer** when handing a remote thread back

256 to your local computer.

2573. Review the destination and branch, then select **Hand off**.

258 

259Codex creates or reuses a worktree on the destination host, transfers the

260thread and Git state, and switches the thread to that host. If the thread is

261running, handoff interrupts the current response before transferring it.

262 

263You can also ask Codex in another thread to hand off a named thread to a

264connected host. Codex can't hand off the thread making the request, and handoff

265to a Codex cloud environment isn't supported.

266 

240## Authentication and network exposure267## Authentication and network exposure

241 268 

242Remote connections use SSH to start and manage the remote Codex app server.269Remote connections use SSH to start and manage the remote Codex app server.