// Forbid accidental stdout/stderr writes in the *library* portion of the TUI. // The standalone `codex-tui` binary prints a short help message before the // alternate‑screen mode starts; that file opts‑out locally via `allow`. #![deny(clippy::print_stdout, clippy::print_stderr)] use app::App; use codex_core::BUILT_IN_OSS_MODEL_PROVIDER_ID; use codex_core::config::Config; use codex_core::config::ConfigOverrides; use codex_core::config::ConfigToml; use codex_core::config::find_codex_home; use codex_core::config::load_config_as_toml_with_cli_overrides; use codex_core::config_types::SandboxMode; use codex_core::protocol::AskForApproval; use codex_core::protocol::SandboxPolicy; use codex_login::CodexAuth; use codex_ollama::DEFAULT_OSS_MODEL; use std::fs::OpenOptions; use std::path::PathBuf; use tracing::error; use tracing_appender::non_blocking; use tracing_subscriber::EnvFilter; use tracing_subscriber::prelude::*; mod app; mod app_event; mod app_event_sender; mod bottom_pane; mod chatwidget; mod citation_regex; mod cli; mod colors; mod common; pub mod custom_terminal; mod diff_render; mod exec_command; mod file_search; mod get_git_diff; mod history_cell; pub mod insert_history; pub mod live_wrap; mod markdown; mod markdown_stream; pub mod onboarding; mod render; mod session_log; mod shimmer; mod slash_command; mod status_indicator_widget; mod streaming; mod text_formatting; mod tui; mod user_approval_widget; // Internal vt100-based replay tests live as a separate source file to keep them // close to the widget code. Include them in unit tests. #[cfg(test)] mod chatwidget_stream_tests; #[cfg(not(debug_assertions))] mod updates; #[cfg(not(debug_assertions))] use color_eyre::owo_colors::OwoColorize; pub use cli::Cli; // (tests access modules directly within the crate) pub async fn run_main( cli: Cli, codex_linux_sandbox_exe: Option, ) -> std::io::Result { let (sandbox_mode, approval_policy) = if cli.full_auto { ( Some(SandboxMode::WorkspaceWrite), Some(AskForApproval::OnFailure), ) } else if cli.dangerously_bypass_approvals_and_sandbox { ( Some(SandboxMode::DangerFullAccess), Some(AskForApproval::Never), ) } else { ( cli.sandbox_mode.map(Into::::into), cli.approval_policy.map(Into::into), ) }; // When using `--oss`, let the bootstrapper pick the model (defaulting to // gpt-oss:20b) and ensure it is present locally. Also, force the built‑in // `oss` model provider. let model = if let Some(model) = &cli.model { Some(model.clone()) } else if cli.oss { Some(DEFAULT_OSS_MODEL.to_owned()) } else { None // No model specified, will use the default. }; let model_provider_override = if cli.oss { Some(BUILT_IN_OSS_MODEL_PROVIDER_ID.to_owned()) } else { None }; // canonicalize the cwd let cwd = cli.cwd.clone().map(|p| p.canonicalize().unwrap_or(p)); let overrides = ConfigOverrides { model, approval_policy, sandbox_mode, cwd, model_provider: model_provider_override, config_profile: cli.config_profile.clone(), codex_linux_sandbox_exe, base_instructions: None, include_plan_tool: Some(true), disable_response_storage: cli.oss.then_some(true), show_raw_agent_reasoning: cli.oss.then_some(true), }; // Parse `-c` overrides from the CLI. let cli_kv_overrides = match cli.config_overrides.parse_overrides() { Ok(v) => v, #[allow(clippy::print_stderr)] Err(e) => { eprintln!("Error parsing -c overrides: {e}"); std::process::exit(1); } }; let mut config = { // Load configuration and support CLI overrides. #[allow(clippy::print_stderr)] match Config::load_with_cli_overrides(cli_kv_overrides.clone(), overrides) { Ok(config) => config, Err(err) => { eprintln!("Error loading configuration: {err}"); std::process::exit(1); } } }; // we load config.toml here to determine project state. #[allow(clippy::print_stderr)] let config_toml = { let codex_home = match find_codex_home() { Ok(codex_home) => codex_home, Err(err) => { eprintln!("Error finding codex home: {err}"); std::process::exit(1); } }; match load_config_as_toml_with_cli_overrides(&codex_home, cli_kv_overrides) { Ok(config_toml) => config_toml, Err(err) => { eprintln!("Error loading config.toml: {err}"); std::process::exit(1); } } }; let should_show_trust_screen = determine_repo_trust_state( &mut config, &config_toml, approval_policy, sandbox_mode, cli.config_profile.clone(), )?; let log_dir = codex_core::config::log_dir(&config)?; std::fs::create_dir_all(&log_dir)?; // Open (or create) your log file, appending to it. let mut log_file_opts = OpenOptions::new(); log_file_opts.create(true).append(true); // Ensure the file is only readable and writable by the current user. // Doing the equivalent to `chmod 600` on Windows is quite a bit more code // and requires the Windows API crates, so we can reconsider that when // Codex CLI is officially supported on Windows. #[cfg(unix)] { use std::os::unix::fs::OpenOptionsExt; log_file_opts.mode(0o600); } let log_file = log_file_opts.open(log_dir.join("codex-tui.log"))?; // Wrap file in non‑blocking writer. let (non_blocking, _guard) = non_blocking(log_file); // use RUST_LOG env var, default to info for codex crates. let env_filter = || { EnvFilter::try_from_default_env() .unwrap_or_else(|_| EnvFilter::new("codex_core=info,codex_tui=info")) }; // Build layered subscriber: let file_layer = tracing_subscriber::fmt::layer() .with_writer(non_blocking) .with_target(false) .with_filter(env_filter()); if cli.oss { codex_ollama::ensure_oss_ready(&config) .await .map_err(|e| std::io::Error::other(format!("OSS setup failed: {e}")))?; } let _ = tracing_subscriber::registry().with(file_layer).try_init(); #[allow(clippy::print_stderr)] #[cfg(not(debug_assertions))] if let Some(latest_version) = updates::get_upgrade_version(&config) { let current_version = env!("CARGO_PKG_VERSION"); let exe = std::env::current_exe()?; let managed_by_npm = std::env::var_os("CODEX_MANAGED_BY_NPM").is_some(); eprintln!( "{} {current_version} -> {latest_version}.", "✨⬆️ Update available!".bold().cyan() ); if managed_by_npm { let npm_cmd = "npm install -g @openai/codex@latest"; eprintln!("Run {} to update.", npm_cmd.cyan().on_black()); } else if cfg!(target_os = "macos") && (exe.starts_with("/opt/homebrew") || exe.starts_with("/usr/local")) { let brew_cmd = "brew upgrade codex"; eprintln!("Run {} to update.", brew_cmd.cyan().on_black()); } else { eprintln!( "See {} for the latest releases and installation options.", "https://github.com/openai/codex/releases/latest" .cyan() .on_black() ); } eprintln!(""); } run_ratatui_app(cli, config, should_show_trust_screen) .map_err(|err| std::io::Error::other(err.to_string())) } fn run_ratatui_app( cli: Cli, config: Config, should_show_trust_screen: bool, ) -> color_eyre::Result { color_eyre::install()?; // Forward panic reports through tracing so they appear in the UI status // line, but do not swallow the default/color-eyre panic handler. // Chain to the previous hook so users still get a rich panic report // (including backtraces) after we restore the terminal. let prev_hook = std::panic::take_hook(); std::panic::set_hook(Box::new(move |info| { tracing::error!("panic: {info}"); prev_hook(info); })); let mut terminal = tui::init(&config)?; terminal.clear()?; // Initialize high-fidelity session event logging if enabled. session_log::maybe_init(&config); let Cli { prompt, images, .. } = cli; let mut app = App::new(config.clone(), prompt, images, should_show_trust_screen); let app_result = app.run(&mut terminal); let usage = app.token_usage(); restore(); // Mark the end of the recorded session. session_log::log_session_end(); // ignore error when collecting usage – report underlying error instead app_result.map(|_| usage) } #[expect( clippy::print_stderr, reason = "TUI should no longer be displayed, so we can write to stderr." )] fn restore() { if let Err(err) = tui::restore() { eprintln!( "failed to restore terminal. Run `reset` or restart your terminal to recover: {err}" ); } } #[allow(clippy::unwrap_used)] fn should_show_login_screen(config: &Config) -> bool { if config.model_provider.requires_openai_auth { // Reading the OpenAI API key is an async operation because it may need // to refresh the token. Block on it. let codex_home = config.codex_home.clone(); match CodexAuth::from_codex_home(&codex_home) { Ok(Some(_)) => false, Ok(None) => true, Err(err) => { error!("Failed to read auth.json: {err}"); true } } } else { false } } /// Determine if user has configured a sandbox / approval policy, /// or if the current cwd project is trusted, and updates the config /// accordingly. fn determine_repo_trust_state( config: &mut Config, config_toml: &ConfigToml, approval_policy_overide: Option, sandbox_mode_override: Option, config_profile_override: Option, ) -> std::io::Result { let config_profile = config_toml.get_config_profile(config_profile_override)?; if approval_policy_overide.is_some() || sandbox_mode_override.is_some() { // if the user has overridden either approval policy or sandbox mode, // skip the trust flow Ok(false) } else if config_profile.approval_policy.is_some() { // if the user has specified settings in a config profile, skip the trust flow // todo: profile sandbox mode? Ok(false) } else if config_toml.approval_policy.is_some() || config_toml.sandbox_mode.is_some() { // if the user has specified either approval policy or sandbox mode in config.toml // skip the trust flow Ok(false) } else if config_toml.is_cwd_trusted(&config.cwd) { // if the current cwd project is trusted and no config has been set // skip the trust flow and set the approval policy and sandbox mode config.approval_policy = AskForApproval::OnRequest; config.sandbox_policy = SandboxPolicy::new_workspace_write_policy(); Ok(false) } else { // if none of the above conditions are met, show the trust screen Ok(true) } }