> ## 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.

# OneWorld Cloud Sessions

OneWorld Cloud Sessions are intelligent Agent runs in the cloud. They are as
capable as coding agents like Codex and Claude, and they give your team a shared
place to start, continue, review, and hand off work with AI.

## Create a session

<Note>
  Session creation is currently in private beta. Both Ask mode and Dev mode may
  make code-level changes, and sessions created under a specific project may
  still encounter bugs. Review the selected project and repository carefully
  before you start.
</Note>

Create a session when you want to ask a question, explore an idea, investigate a
problem, or work with an Agent on a project.

You can start in Ask mode without selecting a project or repository. This is a
good way to chat with an Agent, ask general questions, discuss product ideas, or
get help thinking through a problem.

<Frame>
  <img src="https://mintcdn.com/oneworldai/CoYbsEIpuK6-Ng4n/images/sessions/ask-mode-no-project.png?fit=max&auto=format&n=CoYbsEIpuK6-Ng4n&q=85&s=dea6750794578978674a87309a20653d" alt="Ask mode selected without a project" width="2268" height="782" data-path="images/sessions/ask-mode-no-project.png" />
</Frame>

You can also select a repository from one of your projects. In Ask mode, you can
ask questions about that repository's code, architecture, behavior, or setup.

Use Dev mode when you want the Agent to work directly with the selected
repository. Dev mode is for code-level tasks such as debugging, making changes,
running commands, and preparing implementation work.

<Frame>
  <img src="https://mintcdn.com/oneworldai/CoYbsEIpuK6-Ng4n/images/sessions/dev-mode-selected-repository.png?fit=max&auto=format&n=CoYbsEIpuK6-Ng4n&q=85&s=15d5f20e8db1e0b8627469e97d5c0ec0" alt="Dev mode selected with a repository" width="2860" height="894" data-path="images/sessions/dev-mode-selected-repository.png" />
</Frame>

## Invite your teammate to a session

Open a session detail page, then invite a teammate to join the session. It works
like a group chat: you and your teammates can discuss the work, ask questions,
and collaborate with AI in the same conversation.

<Frame>
  <img src="https://mintcdn.com/oneworldai/UuHhHn3cyPMU_DwK/images/sessions/session-share-button.png?fit=max&auto=format&n=UuHhHn3cyPMU_DwK&q=85&s=cc1f43b7c8856011cf4438d9c361dced" alt="Share button on a session detail page" width="2324" height="968" data-path="images/sessions/session-share-button.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/oneworldai/CoYbsEIpuK6-Ng4n/images/sessions/session-share-dialog.png?fit=max&auto=format&n=CoYbsEIpuK6-Ng4n&q=85&s=4f225e8f8bfd65618238ab44d814a4c9" alt="Share session dialog" width="1682" height="1150" data-path="images/sessions/session-share-dialog.png" />
</Frame>

## Sync a cloud session to your local Agent

<Note title="Notice">
  <ul>
    <li>Local sync currently works with Codex CLI only.</li>
    <li>Localized sessions currently include only the model response text.</li>

    <li>
      The Codex app must be signed in with an official subscription account.
      API-based access is not supported yet.
    </li>
  </ul>
</Note>

You can sync a cloud OneWorld session from the **same project** to your local
Agent and continue unfinished work on your own machine.

<Frame>
  <img src="https://mintcdn.com/oneworldai/9ddnTXeIK7jxKfzG/images/sessions/session-localize-button.png?fit=max&auto=format&n=9ddnTXeIK7jxKfzG&q=85&s=832d8034c1bbe842fb36563e1cee0257" alt="Localize button on a session detail page" width="3036" height="994" data-path="images/sessions/session-localize-button.png" />
</Frame>

Select **Codex CLI**, then go to the Codex app and import the
`~/oneworld-codex` working directory.

<Frame>
  <img src="https://mintcdn.com/oneworldai/9ddnTXeIK7jxKfzG/images/sessions/codex-import-working-directory.png?fit=max&auto=format&n=9ddnTXeIK7jxKfzG&q=85&s=08c89de37a447a58ea233a41477f65b7" alt="Import a working directory in the Codex app" width="1994" height="1030" data-path="images/sessions/codex-import-working-directory.png" />
</Frame>

Once setup is complete, you can see the synced session in Codex and continue
working locally.

<Note>
  After you localize a session to Codex CLI, restart Codex so the newly synced
  session appears under the `oneworld-codex` directory.
</Note>

## When to create a session

Create a session when a task needs more than a quick message. Sessions are useful
for:

* product changes
* bugs and investigations
* customer requests
* code review follow-ups
* QA validation
* agent-assisted implementation