Files
codex/codex-rs/cli/src/desktop_app/windows.rs
T
Eric TrautandFelipe Coury 116317021d Support codex app on macOS (Intel) and Windows (#18500)
## Summary

`codex app` should be a platform-aware entry point for opening Codex
Desktop or helping users install it. Before this change, the command
only existed on macOS and its default installer URL always pointed at
the Apple Silicon DMG, which sent Intel Mac users to the wrong build.

This updates the macOS path to choose the Apple Silicon or Intel DMG
based on the detected processor, while keeping `--download-url` as an
advanced override. It also enables `codex app` on Windows, where the CLI
opens an installed Codex Desktop app when available and otherwise opens
the Windows installer URL.

---------

Co-authored-by: Felipe Coury <felipe.coury@openai.com>
2026-04-19 10:30:13 -07:00

133 lines
3.9 KiB
Rust

use anyhow::Context as _;
use std::path::Path;
use std::path::PathBuf;
use tokio::process::Command;
const CODEX_WINDOWS_INSTALLER_URL: &str =
"https://get.microsoft.com/installer/download/9PLM9XGG6VKS?cid=website_cta_psi";
const CODEX_MICROSOFT_STORE_WEB_URL: &str = "https://apps.microsoft.com/detail/9plm9xgg6vks";
pub async fn run_windows_app_open_or_install(
workspace: PathBuf,
download_url_override: Option<String>,
) -> anyhow::Result<()> {
if let Some(app_id) = find_codex_app_id().await? {
eprintln!("Opening Codex Desktop...");
open_installed_codex_app(&app_id).await?;
eprintln!(
"In Codex Desktop, open workspace {workspace}.",
workspace = display_workspace_path(&workspace)
);
return Ok(());
}
eprintln!("Codex Desktop not found; opening Windows installer...");
let download_url = download_url_override
.as_deref()
.unwrap_or(CODEX_WINDOWS_INSTALLER_URL);
if open_url(download_url).await.is_err() && download_url_override.is_none() {
open_url(CODEX_MICROSOFT_STORE_WEB_URL).await?;
}
eprintln!(
"After installing Codex Desktop, open workspace {workspace}.",
workspace = display_workspace_path(&workspace)
);
Ok(())
}
async fn find_codex_app_id() -> anyhow::Result<Option<String>> {
let output = Command::new("powershell.exe")
.arg("-NoProfile")
.arg("-Command")
.arg("Get-StartApps -Name 'Codex' | Select-Object -First 1 -ExpandProperty AppID")
.output()
.await
.context("failed to invoke `powershell.exe`")?;
if !output.status.success() {
return Ok(None);
}
let app_id = String::from_utf8_lossy(&output.stdout).trim().to_string();
if app_id.is_empty() {
Ok(None)
} else {
Ok(Some(app_id))
}
}
async fn open_installed_codex_app(app_id: &str) -> anyhow::Result<()> {
let target = format!("shell:AppsFolder\\{app_id}");
open_shell_target(&target).await
}
async fn open_url(url: &str) -> anyhow::Result<()> {
let status = Command::new("powershell.exe")
.arg("-NoProfile")
.arg("-Command")
.arg("& { param($target) Start-Process -FilePath $target }")
.arg(url)
.status()
.await
.with_context(|| format!("failed to open {url}"))?;
if status.success() {
Ok(())
} else {
anyhow::bail!("failed to open {url} with {status}");
}
}
async fn open_shell_target(target: &str) -> anyhow::Result<()> {
// Explorer can successfully hand off shell targets and still return exit code 1.
let _status = Command::new("explorer.exe")
.arg(target)
.status()
.await
.with_context(|| format!("failed to open {target}"))?;
Ok(())
}
fn display_workspace_path(workspace: &Path) -> String {
let path = workspace.display().to_string();
if let Some(path) = path.strip_prefix(r"\\?\UNC\") {
format!(r"\\{path}")
} else if let Some(path) = path.strip_prefix(r"\\?\") {
path.to_string()
} else {
path
}
}
#[cfg(test)]
mod tests {
use super::display_workspace_path;
use pretty_assertions::assert_eq;
use std::path::Path;
#[test]
fn display_workspace_path_removes_windows_extended_prefix() {
assert_eq!(
display_workspace_path(Path::new(r"\\?\C:\Users\fcoury\code\codex")),
r"C:\Users\fcoury\code\codex"
);
}
#[test]
fn display_workspace_path_preserves_unc_prefix() {
assert_eq!(
display_workspace_path(Path::new(r"\\?\UNC\server\share\codex")),
r"\\server\share\codex"
);
}
#[test]
fn display_workspace_path_leaves_regular_paths_unchanged() {
assert_eq!(
display_workspace_path(Path::new(r"C:\Users\fcoury\code\codex")),
r"C:\Users\fcoury\code\codex"
);
}
}