Improve codex remote-control CLI UX#22878
Merged
Merged
Conversation
codex remote-control CLI UX
fd52226 to
39d2488
Compare
7d1d019 to
1c10c8d
Compare
39d2488 to
cd3f6bc
Compare
cd3f6bc to
52c9154
Compare
52c9154 to
a37e0df
Compare
This was referenced May 16, 2026
apanasenko-oai
approved these changes
May 18, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
This PR makes
codex remote-controlbehave like a foreground CLI command by default. Running it now starts remote control, waits for readiness, prints a clear status message with the machine name, and stays alive until Ctrl-C.Users who want daemon behavior can use
codex remote-control start, andcodex remote-control stopnow prints concise human-readable output.--jsonremains available for scripts.Implementation-wise, this now verifies the real app-server state instead of just assuming startup worked. The CLI starts or connects to app-server, probes its control socket, calls the
remoteControl/enableAPI, and waits for the remote-control status response/notification before printing success.For daemon mode,
codex remote-control startalso reports which managed app-server binary was used, including its path and best-effortcodex --version, so failures are easier to diagnose.Examples
Example output:
Error case using daemon (currently expected based on our publicly released CLI version):
What changed
codex remote-controlnow runs remote control in the foreground and prints a Ctrl-C stop hint.codex remote-control startstarts the daemon and waits for remote control readiness before reporting success.codex remote-control stopreports stopped/not-running status in plain language.