openai/codex · error · anyhow::Error

`codex agents` requires `--remote` on this platform

Error message

`codex agents` requires `--remote` on this platform

What it means

Error "`codex agents` requires `--remote` on this platform" thrown in openai/codex.

Source

Thrown at codex-rs/cli/src/main.rs:1133

                                        && value.get("writable_roots").is_some())
                            }))
                {
                    anyhow::bail!(
                        "`codex agents` cannot apply local provider or additional-directory overrides to a remote server"
                    );
                }
                if is_workload_identity_selected() {
                    anyhow::bail!(
                        "`codex agents` is unavailable while workload identity is active"
                    );
                }
                if root_remote.is_none() {
                    resolve_remote_endpoint(
                        /*remote*/ None,
                        root_remote_auth_token_env.clone(),
                    )?;
                    #[cfg(not(unix))]
                    anyhow::bail!("`codex agents` requires `--remote` on this platform");
                }
                interactive.agents_overview = true;
            }
            let exit_info = run_interactive_tui(
                interactive,
                root_remote.clone(),
                root_remote_auth_token_env.clone(),
                arg0_paths.clone(),
            )
            .await?;
            handle_app_exit(exit_info)?;
        }
        Some(Subcommand::Exec(mut exec_cli)) => {
            reject_remote_mode_for_subcommand(
                root_remote.as_deref(),
                root_remote_auth_token_env.as_deref(),
                "exec",
            )?;

View on GitHub (pinned to 339751715c)

When it happens

Trigger: Thrown at codex-rs/cli/src/main.rs:1133 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of openai/codex@339751715c (2026-08-25). Data as JSON: /api/errors/3c65802a79cfc77a. Report an issue: GitHub.