Repository navigation
Releases
Codex Remote v0.1.35
Codex Remote v0.1.35
Complete Codex App Server handshake.
Highlights
- Sends the required
initializednotification afterinitialize. - Prevents the App Server from resetting a successfully opened WebSocket session.
- Skips chats currently owned by another Codex client and opens the first available chat.
- Keeps the responsive offline controls and persisted-chat fixes from v0.1.34.
- Adds regression coverage for initialization message ordering.
Install
Download CodexRemote.zip from the release, extract it, and copy the CodexRemote folder to:
/home/deck/homebrew/plugins/CodexRemote
Then restart Decky Loader:
sudo systemctl restart plugin_loader.serviceNotes
This is an alpha release. Codex App Server WebSocket support is experimental upstream, so expect protocol changes.
Codex Remote v0.1.34
Codex Remote v0.1.34
Responsive offline controls and reliable persisted chats.
Highlights
- Keeps Decky RPC responsive while an offline App Server reconnects in the background.
- Restores Scan, Link, Check, and other controls when the configured endpoint is unavailable.
- Resumes persisted App Server threads before reading them or sending a new turn.
- Shows a normal disconnected state when an action cannot reach the server.
- Adds regression coverage for the offline polling queue and persisted chats.
Install
Download CodexRemote.zip from the release, extract it, and copy the CodexRemote folder to:
/home/deck/homebrew/plugins/CodexRemote
Then restart Decky Loader:
sudo systemctl restart plugin_loader.serviceNotes
This is an alpha release. Codex App Server WebSocket support is experimental upstream, so expect protocol changes.
Codex Remote v0.1.33
Codex Remote v0.1.33
Connection-mode UX and diagnostics.
Highlights
- Adds LAN/Remote URL mode selection on the Setup page.
- Shows only the relevant endpoint fields for the selected mode.
- Adds diagnostics for endpoint, token, proxy reachability, and VPN tunnel state.
- Keeps optional HTTP CONNECT proxy support for split VPN clients.
- Keeps remote endpoint hardening from v0.1.32.
Install
Download CodexRemote.zip from the release, extract it, and copy the CodexRemote folder to:
/home/deck/homebrew/plugins/CodexRemote
Then restart Decky Loader:
sudo systemctl restart plugin_loader.serviceNotes
This is an alpha release. Codex App Server WebSocket support is experimental upstream, so expect protocol changes.
Codex Remote v0.1.28
Codex Remote v0.1.28
CSS Loader-inspired Decky UX polish.
Highlights
- Replaces the custom tab strip with a native Decky
DropdownItemview selector. - Uses
PanelSectiontitles for the active view, closer to CSS Loader's Quick Access layout. - Keeps compact pages for Remote, Chats, Auth, Setup, and Log.
- Keeps the Remote page focused on current chat, task, approvals, transcript, quick actions, and composer.
- Moves chat search and selection into a dedicated Chats page.
- Moves ChatGPT account checks and device-code login into a dedicated Auth page.
- Moves LAN scan, Link, Check, Disconnect, host, port, token, and live updates into Setup.
- Adds a lightweight Log page for connection, account, action, and App Server messages.
- Keeps the secure App Server token flow from v0.1.26.
- Waits for Codex App Server
initializeand the first thread snapshot before reporting Connected. - Prevents stale disconnected UI immediately after a successful WebSocket link.
- Treats connection initialization as a transient state instead of a failure.
- Fixes the header Hide button so it actually closes setup when a host is configured.
- Only forces setup open when no host is configured.
- Lets the main remote screen show even if the configured Codex server is currently offline.
- Hides chat, transcript, and composer while setup is open so the bottom of the panel is not clipped.
- Keeps setup focused on Scan, Link, Account, advanced settings, and diagnostics.
- Keeps the compact transcript, clamped current task, and softer scrollbar from v0.1.21.
- Keeps searchable chats, quick commands, focused approvals, structured transcript cards, and auto-scroll from v0.1.20.
- Verified through package build, Python backend checks, Deck install, Decky logs, and live QuickAccess inspection.
Install
Download CodexRemote.zip from the release, extract it, and copy the CodexRemote folder to:
/home/deck/homebrew/plugins/CodexRemote
Then restart Decky Loader:
sudo systemctl restart plugin_loader.serviceNotes
This is an alpha release. Codex App Server WebSocket support is experimental upstream, so expect protocol changes.
Codex Remote v0.1.27
Codex Remote v0.1.27
Focused multi-page Quick Access UI.
Highlights
- Adds compact page navigation for Remote, Chats, Auth, Setup, and Log.
- Keeps the Remote page focused on current chat, task, approvals, transcript, quick actions, and composer.
- Moves chat search and selection into a dedicated Chats page.
- Moves ChatGPT account checks and device-code login into a dedicated Auth page.
- Moves LAN scan, Link, Check, Disconnect, host, port, token, and live updates into Setup.
- Adds a lightweight Log page for connection, account, action, and App Server messages.
- Keeps the secure App Server token flow from v0.1.26.
- Waits for Codex App Server
initializeand the first thread snapshot before reporting Connected. - Prevents stale disconnected UI immediately after a successful WebSocket link.
- Treats connection initialization as a transient state instead of a failure.
- Fixes the header Hide button so it actually closes setup when a host is configured.
- Only forces setup open when no host is configured.
- Lets the main remote screen show even if the configured Codex server is currently offline.
- Hides chat, transcript, and composer while setup is open so the bottom of the panel is not clipped.
- Keeps setup focused on Scan, Link, Account, advanced settings, and diagnostics.
- Keeps the compact transcript, clamped current task, and softer scrollbar from v0.1.21.
- Keeps searchable chats, quick commands, focused approvals, structured transcript cards, and auto-scroll from v0.1.20.
- Verified through package build, Python backend checks, Deck install, Decky logs, and live QuickAccess inspection.
Install
Download CodexRemote.zip from the release, extract it, and copy the CodexRemote folder to:
/home/deck/homebrew/plugins/CodexRemote
Then restart Decky Loader:
sudo systemctl restart plugin_loader.serviceNotes
This is an alpha release. Codex App Server WebSocket support is experimental upstream, so expect protocol changes.
Codex Remote v0.1.26
Codex Remote v0.1.26
Secure App Server setup pass.
Highlights
- Requires an App Server capability token before opening the WebSocket control channel.
- Keeps LAN scan as
/readyzdiscovery whileLinkvalidates the token. - Promotes
Accountinto setup and moves ChatGPT device-code login into an Account card. - Shows token-specific feedback for
401/403WebSocket handshake failures. - Updates README setup/security notes to match OpenAI's Codex App Server documentation.
- Waits for Codex App Server
initializeand the first thread snapshot before reporting Connected. - Prevents stale disconnected UI immediately after a successful WebSocket link.
- Treats connection initialization as a transient state instead of a failure.
- Fixes the header Hide button so it actually closes setup when a host is configured.
- Only forces setup open when no host is configured.
- Lets the main remote screen show even if the configured Codex server is currently offline.
- Hides chat, transcript, and composer while setup is open so the bottom of the panel is not clipped.
- Keeps setup focused on Scan, Link, Account, advanced settings, and diagnostics.
- Keeps the compact transcript, clamped current task, and softer scrollbar from v0.1.21.
- Keeps searchable chats, quick commands, focused approvals, structured transcript cards, and auto-scroll from v0.1.20.
- Verified through package build, Python backend checks, Deck install, Decky logs, and live QuickAccess inspection.
Install
Download CodexRemote.zip from the release, extract it, and copy the CodexRemote folder to:
/home/deck/homebrew/plugins/CodexRemote
Then restart Decky Loader:
sudo systemctl restart plugin_loader.serviceNotes
This is an alpha release. Codex App Server WebSocket support is experimental upstream, so expect protocol changes.
Codex Remote v0.1.25
Codex Remote v0.1.25
Public setup documentation pass.
Highlights
- Cleans up the README for public users instead of MVP-only development.
- Adds Windows Firewall guidance for the default Codex App Server port.
- Adds troubleshooting for LAN scan, Link, ChatGPT login, and disabled controls.
- Expands security notes around firewall scope and token exposure.
- Waits for Codex App Server
initializeand the first thread snapshot before reporting Connected. - Prevents stale disconnected UI immediately after a successful WebSocket link.
- Treats connection initialization as a transient state instead of a failure.
- Fixes the header Hide button so it actually closes setup when a host is configured.
- Only forces setup open when no host is configured.
- Lets the main remote screen show even if the configured Codex server is currently offline.
- Hides chat, transcript, and composer while setup is open so the bottom of the panel is not clipped.
- Keeps setup focused on Scan, Link, ChatGPT, advanced settings, and diagnostics.
- Keeps the compact transcript, clamped current task, and softer scrollbar from v0.1.21.
- Keeps searchable chats, quick commands, focused approvals, structured transcript cards, and auto-scroll from v0.1.20.
- Verified through package build, Python backend checks, Deck install, Decky logs, and live QuickAccess inspection.
Install
Download CodexRemote.zip from the release, extract it, and copy the CodexRemote folder to:
/home/deck/homebrew/plugins/CodexRemote
Then restart Decky Loader:
sudo systemctl restart plugin_loader.serviceNotes
This is an alpha release. Codex App Server WebSocket support is experimental upstream, so expect protocol changes.
Codex Remote v0.1.24
Codex Remote v0.1.24
Connection readiness fix.
Highlights
- Waits for Codex App Server
initializeand the first thread snapshot before reporting Connected. - Prevents stale disconnected UI immediately after a successful WebSocket link.
- Treats connection initialization as a transient state instead of a failure.
- Fixes the header Hide button so it actually closes setup when a host is configured.
- Only forces setup open when no host is configured.
- Lets the main remote screen show even if the configured Codex server is currently offline.
- Hides chat, transcript, and composer while setup is open so the bottom of the panel is not clipped.
- Keeps setup focused on Scan, Link, ChatGPT, advanced settings, and diagnostics.
- Keeps the compact transcript, clamped current task, and softer scrollbar from v0.1.21.
- Keeps searchable chats, quick commands, focused approvals, structured transcript cards, and auto-scroll from v0.1.20.
- Verified through package build, Python backend checks, Deck install, Decky logs, and live QuickAccess inspection.
Install
Download CodexRemote.zip from the release, extract it, and copy the CodexRemote folder to:
/home/deck/homebrew/plugins/CodexRemote
Then restart Decky Loader:
sudo systemctl restart plugin_loader.serviceNotes
This is an alpha release. Codex App Server WebSocket support is experimental upstream, so expect protocol changes.
Codex Remote v0.1.20
Codex Remote v0.1.20
Smarter Deck panel controls.
Highlights
- Adds a searchable chat picker with loaded-chat markers.
- Adds quick commands for Continue, Explain, Retry, and Summary.
- Turns approvals into one focused card with command details and Approve/Deny actions.
- Shows a more useful current task derived from the latest Codex event.
- Keeps transcript auto-scroll and structured cards for messages, commands, tools, files, approvals, and errors.
- Verified through package build and Python backend checks.
Install
Download CodexRemote.zip from the release, extract it, and copy the CodexRemote folder to:
/home/deck/homebrew/plugins/CodexRemote
Then restart Decky Loader:
sudo systemctl restart plugin_loader.serviceNotes
This is an alpha release. Codex App Server WebSocket support is experimental upstream, so expect protocol changes.
Codex Remote v0.1.19
Codex Remote v0.1.19
Auto-scroll transcript tail.
Highlights
- Automatically keeps the transcript pinned to the latest message.
- Updates the scroll position during refreshes and streaming text growth.
- Removes custom D-pad transcript scroll interception.
- Avoids relying on Steam Deck scrollbar activation.
- Keeps the transcript inside Decky's native scroll components.
- Keeps the v0.1.14 structured transcript cards and streaming behavior.
- Verified through package build and Python backend checks.
Install
Download CodexRemote.zip from the release, extract it, and copy the CodexRemote folder to:
/home/deck/homebrew/plugins/CodexRemote
Then restart Decky Loader:
sudo systemctl restart plugin_loader.serviceNotes
This is an alpha release. Codex App Server WebSocket support is experimental upstream, so expect protocol changes.