Documentation 2026-10-05 23:57 UTC to 2026-10-06 23:02 UTC

2 2 

3> For the complete documentation index, see [llms.txt](https://learn.chatgpt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to the page URL.3> For the complete documentation index, see [llms.txt](https://learn.chatgpt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to the page URL.

4 4 

5## Your command center for complex work5## ChatGPT desktop app

6 6 

7Run projects in parallel, work with files, use your computer, and keep long-running work moving from one desktop workspace.7Run projects in parallel, work with files, use your computer, and keep long-running work moving from one desktop workspace.

8 8 

27 icon: "folder",27 icon: "folder",

28 },28 },

29 {29 {

30 title: "Codex Remote",30 title: "Codex on mobile",

31 description:31 description:

32 "Start tasks, approve actions, and review work from your phone.",32 "Start tasks, approve actions, and review work from your phone.",

33 href: "/codex/remote",33 href: "/codex/mobile",

34 icon: "connect",34 icon: "connect",

35 },35 },

36 {36 {

2 2 

3> For the complete documentation index, see [llms.txt](https://learn.chatgpt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to the page URL.3> For the complete documentation index, see [llms.txt](https://learn.chatgpt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to the page URL.

4 4 

5Worktrees let Codex run multiple independent chats in the same project without interfering with each other. The repository, worktree, and commands remain on the computer or remote development environment that contains the project. You can work directly in the ChatGPT desktop app, or use [Remote](https://learn.chatgpt.com/docs/remote) in the ChatGPT mobile app to start, guide, approve, and review worktree chats on a connected computer.5Worktrees let Codex run multiple independent chats in the same project without interfering with each other. The repository, worktree, and commands remain on the computer or remote development environment that contains the project. You can work directly in the ChatGPT desktop app, or use [Codex](https://learn.chatgpt.com/docs/mobile) in the ChatGPT mobile app to start, guide, approve, and review worktree chats on a connected computer.

6 6 

7For Git repositories, [scheduled tasks](https://learn.chatgpt.com/docs/automations) can run on dedicated background worktrees so they don't conflict with your ongoing work. In non-version-controlled projects, scheduled tasks run directly in the project directory. You can also start chats in a worktree manually and use Handoff to move a chat between Local and Worktree.7For Git repositories, [scheduled tasks](https://learn.chatgpt.com/docs/automations) can run on dedicated background worktrees so they don't conflict with your ongoing work. In non-version-controlled projects, scheduled tasks run directly in the project directory. You can also start chats in a worktree manually and use Handoff to move a chat between Local and Worktree.

8 8 

9Worktrees don't run locally on your phone. With Remote, the mobile app9Worktrees don't run locally on your phone. The ChatGPT mobile app controls

10 controls Codex on your connected computer, where the repository and worktree10 Codex on your connected computer, where the repository and worktree remain, or

11 remain, or in the remote development environment that computer uses. The11 in the remote development environment that computer uses. The desktop-specific

12 desktop-specific instructions below apply on the connected computer.12 instructions below apply on the connected computer.

13 13 

14## What's a worktree14## What's a worktree

15 15 

199their prior express consent. Consider pausing it or excluding apps that contain199their prior express consent. Consider pausing it or excluding apps that contain

200sensitive health, financial, or personal information.200sensitive health, financial, or personal information.

201 201 

202When you pause Computer History, no new interaction events will be collected, but

203an in-flight summary of previous events may still continue until it's finished.

204 

202## Review and clear history205## Review and clear history

203 206 

204Open **Settings > Computer history > History** to inspect what Computer History207Open **Settings > Computer history > History** to inspect what Computer History

2 2 

3> For the complete documentation index, see [llms.txt](https://learn.chatgpt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to the page URL.3> For the complete documentation index, see [llms.txt](https://learn.chatgpt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to the page URL.

4 4 

5Worktrees let Codex run multiple independent chats in the same project without interfering with each other. The repository, worktree, and commands remain on the computer or remote development environment that contains the project. You can work directly in the ChatGPT desktop app, or use [Remote](https://learn.chatgpt.com/docs/remote) in the ChatGPT mobile app to start, guide, approve, and review worktree chats on a connected computer.5Worktrees let Codex run multiple independent chats in the same project without interfering with each other. The repository, worktree, and commands remain on the computer or remote development environment that contains the project. You can work directly in the ChatGPT desktop app, or use [Codex](https://learn.chatgpt.com/docs/mobile) in the ChatGPT mobile app to start, guide, approve, and review worktree chats on a connected computer.

6 6 

7For Git repositories, [scheduled tasks](https://learn.chatgpt.com/docs/automations) can run on dedicated background worktrees so they don't conflict with your ongoing work. In non-version-controlled projects, scheduled tasks run directly in the project directory. You can also start chats in a worktree manually and use Handoff to move a chat between Local and Worktree.7For Git repositories, [scheduled tasks](https://learn.chatgpt.com/docs/automations) can run on dedicated background worktrees so they don't conflict with your ongoing work. In non-version-controlled projects, scheduled tasks run directly in the project directory. You can also start chats in a worktree manually and use Handoff to move a chat between Local and Worktree.

8 8 

9Worktrees don't run locally on your phone. With Remote, the mobile app9Worktrees don't run locally on your phone. The ChatGPT mobile app controls

10 controls Codex on your connected computer, where the repository and worktree10 Codex on your connected computer, where the repository and worktree remain, or

11 remain, or in the remote development environment that computer uses. The11 in the remote development environment that computer uses. The desktop-specific

12 desktop-specific instructions below apply on the connected computer.12 instructions below apply on the connected computer.

13 13 

14## What's a worktree14## What's a worktree

15 15 

27 icon: "folder",27 icon: "folder",

28 },28 },

29 {29 {

30 title: "Codex Remote",30 title: "Codex on mobile",

31 description:31 description:

32 "Start tasks, approve actions, and review work from your phone.",32 "Start tasks, approve actions, and review work from your phone.",

33 href: "/codex/remote",33 href: "/codex/mobile",

34 icon: "connect",34 icon: "connect",

35 },35 },

36 {36 {

10Pro, Business, Edu, and Enterprise plans. Enterprise and Edu availability10Pro, Business, Edu, and Enterprise plans. Enterprise and Edu availability

11begins with a two-week early-access period before the feature becomes available11begins with a two-week early-access period before the feature becomes available

12by default. You can also use ChatGPT Voice through12by default. You can also use ChatGPT Voice through

13[Remote on iOS](https://learn.chatgpt.com/docs/remote-connections#set-up-mobile-access) after pairing13[Codex on iOS](https://learn.chatgpt.com/docs/remote-connections#set-up-mobile-access) after pairing

14your phone with a desktop host. Availability also depends on rollout status and14your phone with a desktop host. Availability also depends on rollout status and

15workspace settings. See [feature availability](https://learn.chatgpt.com/docs/pricing#feature-availability).15workspace settings. See [feature availability](https://learn.chatgpt.com/docs/pricing#feature-availability).

16 16 

232 href: "/codex/remote-connections#what-comes-from-the-connected-host",232 href: "/codex/remote-connections#what-comes-from-the-connected-host",

233 appliesTo: "Desktop app, Mobile",233 appliesTo: "Desktop app, Mobile",

234 description:234 description:

235 "Computer or development environment that provides files, tools, and shell access for ChatGPT or Codex chats opened through Remote.",235 "Computer or development environment that provides files, tools, and shell access for ChatGPT or Codex chats opened through remote connections.",

236 },236 },

237 {237 {

238 key: "Connector",238 key: "Connector",

1# Codex Remote1# Codex on mobile

2 2 

3> For the complete documentation index, see [llms.txt](https://learn.chatgpt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to the page URL.3> For the complete documentation index, see [llms.txt](https://learn.chatgpt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to the page URL.

4 4 

5## Start, guide, and review coding tasks from your phone5## Start, guide, and review tasks from your phone

6 6 

7Follow progress, approve actions, and send instructions from your phone. Codex runs each task on your connected computer.7Follow progress, approve actions, and send instructions from your phone. Codex runs tasks in the cloud or on a connected computer.

8 8 

9Use the ChatGPT mobile app with a connected Mac or Windows PC. Availability depends on rollout and your workspace settings.9Use the ChatGPT mobile app with Cloud or a connected Mac or Windows PC. Availability depends on rollout and your workspace settings.

10 10 

11> Illustration: Interactive Codex Remote mobile app showing connected computers, tasks, conversations, approvals, and changed files11> Illustration: Interactive Codex experience in the ChatGPT mobile app showing Cloud, connected computers, tasks, conversations, approvals, and changed files

12 12 

13### Start here13### Start here

14 14 

15- [Set up Remote](#set-up-remote)15- [Set up mobile access](#set-up-remote)

16- [Remote connections guide](https://learn.chatgpt.com/docs/remote-connections)16- [Remote connections guide](https://learn.chatgpt.com/docs/remote-connections)

17 17 

18## Codex Remote advantages18## Codex on mobile advantages

19 19 

20- **Start tasks from your phone:** Choose a connected computer and project, describe the task, and let Codex get to work.20- **Start tasks from your phone:** Choose Cloud and an environment, or a connected computer and project, then describe the task.

21- **Guide work as it happens:** Open a task, follow its progress, and send new instructions without returning to your desk.21- **Guide work as it happens:** Open a task, follow its progress, and send new instructions without returning to your desk.

22- **Approve requested actions:** Review requested commands and actions before Codex continues on your connected computer.22- **Approve requested actions:** Review requested commands and actions before Codex continues on your connected computer.

23- **Review the result:** Inspect responses, changed files, diffs, and test results, then decide what happens next.23- **Review the result:** Inspect responses, changed files, diffs, and test results, then decide what happens next.

24 24 

25## Get started with Remote25## Get started on mobile

26 26 

27Connect your computer, approve access, and start your first task.27Connect your computer, approve access, and start your first task.

28 28 

32 32 

33## Keep work moving from anywhere33## Keep work moving from anywhere

34 34 

35Start, approve, and review tasks from your phone. Your connected computer runs the work under your organization’s security policies.35Start, approve, and review tasks from your phone. Codex runs the work under your organization’s security policies.

36 36 

37### 1. See tasks running on your computer37### 1. See tasks across your hosts

38 38 

39Follow active tasks across connected computers, pick up existing conversations, and see when your input is needed.39Follow active tasks in Cloud and across connected computers, pick up existing conversations, and see when your input is needed.

40 40 

41> Illustration: Codex Remote task list showing active tasks on a connected computer41> Illustration: Codex on mobile task list showing Cloud and connected computers

42 42 

43### 2. Approve requests43### 2. Approve requests

44 44 

45Review commands and requested actions before Codex continues working on your connected computer.45Review commands and requested actions before Codex continues working on your connected computer.

46 46 

47> Illustration: Codex Remote approval request for a terminal command47> Illustration: Codex on mobile approval request for a terminal command

48 48 

49### 3. Review changed code49### 3. Review changed code

50 50 

51Inspect changed files and diffs from your phone before deciding what happens next.51Inspect changed files and diffs from your phone before deciding what happens next.

52 52 

53> Illustration: Codex Remote changed-files review with code differences53> Illustration: Codex on mobile changed-files review with code differences

54 54 

55### 4. Start new tasks55### 4. Start new tasks

56 56 

57Choose a connected computer and project, describe the task, and let Codex get to work.57Choose Cloud and an environment, or a connected computer and project, then describe the task.

58 58 

59> Illustration: Codex Remote new-task composer for a connected computer59> Illustration: Codex on mobile new-task composer for a connected computer

60 60 

61## Explore setup and security61## Explore setup and security

62 62 

21 21 

22When your workspace enables Local computer access with Work Cloud, eligible ChatGPT Work conversations can continue across desktop, mobile, and web. OpenAI's cloud coordinates the task, and an online, connected computer can execute steps that need its local resources.22When your workspace enables Local computer access with Work Cloud, eligible ChatGPT Work conversations can continue across desktop, mobile, and web. OpenAI's cloud coordinates the task, and an online, connected computer can execute steps that need its local resources.

23 23 

24Use the Local computer access with Work Cloud guidance for conversations using this feature. The Remote and SSH instructions below apply to the existing supported host-connection workflows. The setup required to view a conversation using this feature may differ from the setup for a Codex host connection.24Use the Local computer access with Work Cloud guidance for conversations using this feature. The remote access and SSH instructions below apply to the existing supported host-connection workflows. The setup required to view a conversation using this feature may differ from the setup for a Codex host connection.

25 25 

26Local computer access with Work Cloud applies only to tasks created after you enable sync. Existing tasks, including tasks in projects, keep their original mode: locally only, or in the cloud without access to local files. Start a new task to use this feature.26Local computer access with Work Cloud applies only to tasks created after you enable sync. Existing tasks, including tasks in projects, keep their original mode: locally only, or in the cloud without access to local files. Start a new task to use this feature.

27 27 

28If the computer is unavailable when a new turn starts, an existing eligible task using local computer access with Work Cloud can continue in a cloud container. The cloud container cannot access files or tools on the unavailable computer. It also does not enforce enterprise requirements from local execution. A task cannot switch from local execution to the cloud during a turn. This feature does not change Codex Remote behavior.28If the computer is unavailable when a new turn starts, an existing eligible task using local computer access with Work Cloud can continue in a cloud container. The cloud container cannot access files or tools on the unavailable computer. It also does not enforce enterprise requirements from local execution. A task cannot switch from local execution to the cloud during a turn. This feature does not change how Codex on mobile connects to a host.

29 29 

30## What you can do remotely30## What you can do remotely

31 31 

45 45

46 46

47 47 

48> Illustration: Remote setup screen in the ChatGPT mobile app48> Illustration: Mobile connection setup screen in the ChatGPT mobile app

49 49 

50 50 

51 51

52 52 

53 53 

54 54 

55<a id="before-you-set-up-mobile-access"></a>55<a id="before-you-set-up-remote"></a>

56 56 

57## Before you set up Remote57## Before you set up mobile access

58 58 

59Remote supports hosts running the ChatGPT desktop app on macOS and Windows.59Remote access supports hosts running the ChatGPT desktop app on macOS and

60 You can control a host from ChatGPT on iOS or Android, or from another Mac or60 Windows. You can control a host from ChatGPT on iOS or Android, or from

61 Windows device when **Control other devices** is available. Availability can61 another Mac or Windows device when **Control other devices** is available.

62 vary by rollout.62 Availability can vary by rollout.

63 63 

64Make sure you have:64Make sure you have:

65 65 

76If you use Codex through a ChatGPT workspace, your admin may need to enable76If you use Codex through a ChatGPT workspace, your admin may need to enable

77Remote Control access before you can connect from your phone.77Remote Control access before you can connect from your phone.

78 78 

79<a id="set-up-mobile-access"></a>79<a id="set-up-remote"></a>

80 80 

81## Set up Remote81## Set up mobile access

82 82 

83Start in the ChatGPT desktop app on the host you want to connect. The setup flow83Start in the ChatGPT desktop app on the host you want to connect. The setup flow

84enables remote access for that host, then shows a QR code you can scan from your84enables remote access for that host, then shows a QR code you can scan from your

92 92 

93<WorkflowSteps variant="headings">93<WorkflowSteps variant="headings">

94 94 

951. Start Remote setup.951. Start setup on your computer.

96 96 

97 Open the ChatGPT desktop app on the host. Go to **Settings** >97 Open the ChatGPT desktop app on the host. Go to **Settings** >

98 **Connections** > **Control this Mac or PC**, then select **Set up** or98 **Connections** > **Control this Mac or PC**, then select **Set up** or

42 42 

43No. Codex Security complements SAST. It adds semantic, LLM-based reasoning and automated validation, while existing SAST tools still provide broad deterministic coverage.43No. Codex Security complements SAST. It adds semantic, LLM-based reasoning and automated validation, while existing SAST tools still provide broad deterministic coverage.

44 44 

45## Billing

46 

47### How are Cloud scans billed?

48 

49Repository scans and continuous scans set up after October 1, 2026, at

5012:53 PM Pacific are billed based on token usage at your plan's rates, in

51credits or USD depending on your billing plan. For

52[eligible accounts](#do-i-get-a-free-scanning-period-or-free-scanning-credits),

53free scanning credits apply before paid usage is billed.

54 

55This usage is not covered by your plan's included usage allowance.

56 

57Continuous scans set up before that cutoff are free for 14 days, until

58October 15, 2026. After that, they are billed at regular token rates under

59your account's billing plan if you enable paid usage. Otherwise, they pause.

60 

61### Do I get a free scanning period or free scanning credits?

62 

63What you receive depends on whether your account had continuous scanning set

64up before October 1, 2026, at 12:53 PM Pacific:

65 

66- If it did, your covered continuous scans remain free until October 15, 2026.

67 This free period doesn't cover repository scans or continuous scanning set

68 up after October 1, 2026, at 12:53 PM Pacific.

69- If it didn't, eligible accounts receive $500 in free scanning credits

70 instead of the free continuous-scanning period.

71 

72### How do free scanning credits work?

73 

74Repository scans and continuous scanning use the same free balance. In a

75workspace, everyone shares that balance. These free scanning credits don't

76expire.

77 

78When the free balance runs out, further scanning is billed under your

79account's or workspace's billing plan.

80 

81### What happens when the free continuous-scanning period ends?

82 

83Select **Keep scans running** and enable paid usage to continue these scans

84after the free period. They are then billed at regular token rates under

85your account's or workspace's billing plan.

86 

87If you opt out or don't enable paid usage, those scans pause when the free

88period ends. Select **Re-enable scans** to enable paid usage afterward.

89In a workspace, ask a workspace owner to make this choice if you don't have

90permission.

91 

92### Where can I see token usage and charges?

93 

94Open a scan in **Scans** to review its token usage and cost. Hover over the

95token count to see input, cached input, and output tokens. Cached input is

96included in the input count, not added on top of it.

97 

98Usage shows the cost before free scanning credits or billing exemptions,

99along with any amount covered by free scanning credits.

100 

101Scans marked "Exempt from billing. No charges apply." incur no charges,

102even when they show token usage and cost.

103 

45## Features104## Features

46 105 

47### What is the analysis pipeline?106### What is the analysis pipeline?