English | 简体中文
Codex Pane is a Windows 11 desktop workbench built on Codex app-server. The desktop app offers multi-pane and session-sidebar layouts, while the optional self-hosted relay lets you continue conversations securely from a mobile browser.
- Make sure
codexworks in PowerShell 7. - Open the
win-unpackeddirectory. - Run
Codex Pane.exeand choose a default working directory.
Run several independent conversations in one window. Each pane has its own conversation, working directory, model, reasoning effort, and permission state.
Focus on the current conversation while browsing, searching, and switching history from the sidebar. Switch desktop layouts at any time in Settings.
Use an iPhone or another modern mobile browser to view history, create and switch conversations, send text messages, and confirm eligible command or MCP operations.
- Create, resume, rename, search, and switch conversations.
- View replies, commands, diffs, tool calls, approvals, images, subagents, and background tasks.
- Set a global or per-pane working directory, and switch models, reasoning effort, and permission modes from the composer.
- Use
/for commands,@for Skills, and$for workspace files. - Attach local files and images or paste images directly; successful imports are kept when part of a batch fails.
- MCP forms and choice answers are sent only after explicit submission.
- Use
F11to enter or leave full screen;Escand the top-right action also exit full screen.
Remote access is optional and disabled by default. To enable it:
- Deploy the relay by following the remote deployment guide.
- Open Settings → Remote Access, enter the HTTPS relay address, enable remote access, and save.
- Generate a pairing QR code and scan it with your phone.
- Create the Passkey on the phone, verify the matching six-digit code, and confirm the phone on the desktop.
The mobile client can view, create, and switch conversations, send text messages, and provide one-time confirmation for eligible command or MCP operations. Models, permissions, working directories, file approvals, credentials, and other high-risk controls remain desktop-only.
The relay has no account database and cannot read remote messages. Phone-to-desktop messages are end-to-end encrypted, while Passkey verification and device authorization stay on the desktop.
/agents · /cd · /compact · /fast · /goal · /mcp · /new · /permissions · /plan · /ps · /rename · /resume · /review · /skills · /status · /stop
Application data is stored in the data directory beside the application.
Requires Node.js 24 or later.
npm install
npm run dev
npm run verify
npm run package:winpackage:win creates the unpacked Windows application in release/win-unpacked. See remote for relay and mobile development and deployment.