> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneworldai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sync Local Agent Sessions

You can connect local Agent working directories from the Computers page and sync
the sessions inside those directories to OneWorld.

## Connect a working directory

Open the Computers page, choose the Computer you want to use, then connect the
working directory where your local Agent stores project work.

Choose the directory that matches the project or repository you want to sync.
OneWorld uses this connection to find local Agent sessions that belong to that
work area.

<Frame>
  <img src="https://mintcdn.com/oneworldai/CoYbsEIpuK6-Ng4n/images/sessions/connect-project-button.png?fit=max&auto=format&n=CoYbsEIpuK6-Ng4n&q=85&s=c1b6e0d296c9048ce7a51f16cce69f2b" alt="Connect project button on the Computers page" width="2322" height="654" data-path="images/sessions/connect-project-button.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/oneworldai/CoYbsEIpuK6-Ng4n/images/sessions/connect-local-project-dialog.png?fit=max&auto=format&n=CoYbsEIpuK6-Ng4n&q=85&s=c4d5c4138717165de367fa6172304c96" alt="Connect a local project dialog" width="1690" height="1204" data-path="images/sessions/connect-local-project-dialog.png" />
</Frame>

## Sync local sessions to OneWorld

After the working directory is connected, OneWorld can bring the local sessions
from that directory into the OneWorld platform.

Use the Share button when you have already started work in a local coding Agent
and want the session to become visible in OneWorld for review, collaboration, or
handoff.

<Frame>
  <img src="https://mintcdn.com/oneworldai/UuHhHn3cyPMU_DwK/images/sessions/synced-local-sessions.png?fit=max&auto=format&n=UuHhHn3cyPMU_DwK&q=85&s=23854843244892a0e10a6089ba7696f3" alt="Local Agent sessions synced into OneWorld Collaborations" width="2824" height="1766" data-path="images/sessions/synced-local-sessions.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/oneworldai/9ddnTXeIK7jxKfzG/images/sessions/local-session-share-dialog.png?fit=max&auto=format&n=9ddnTXeIK7jxKfzG&q=85&s=2e28194b1c4399c85a490fa8067a8b4c" alt="Share dialog for a synced local Agent session" width="1656" height="1194" data-path="images/sessions/local-session-share-dialog.png" />
</Frame>

## What gets synced

The synced session keeps the useful work context from your local Agent so your
team can open it from OneWorld and continue from the same thread.

## When to use this

Use local session sync when:

* you started work locally before creating a OneWorld Cloud Session
* you want teammates to review local Agent progress in OneWorld
* you want to hand off unfinished local work to another teammate
* you want OneWorld to become the shared place for ongoing collaboration
