global Codex enablement is only supported for Codex sessions

Error message

global Codex enablement is only supported for Codex sessions; use `f codex enable-global`

What it means

Global Codex enablement (EnableGlobal action) applies only to Codex sessions. Requesting it with Provider::Cursor makes run_provider bail with this message pointing at `f codex enable-global`.

Source

Thrown at src/ai.rs:581

            }) => show_session(session, Provider::Cursor, count, path, full)?,
            Some(ProviderAiAction::Runtime { .. }) => {
                bail!(
                    "runtime helpers are only supported for Codex sessions; use `f codex runtime ...`"
                );
            }
            Some(ProviderAiAction::Doctor { .. }) => {
                bail!("doctor is only supported for Codex sessions; use `f codex doctor`");
            }
            Some(ProviderAiAction::Eval { .. }) => {
                bail!("eval is only supported for Codex sessions; use `f codex eval`");
            }
            Some(ProviderAiAction::TouchLaunch { .. }) => {
                bail!(
                    "touch-launch is only supported for Codex sessions; use `f codex touch-launch`"
                );
            }
            Some(ProviderAiAction::EnableGlobal { .. }) => {
                bail!(
                    "global Codex enablement is only supported for Codex sessions; use `f codex enable-global`"
                );
            }
            Some(ProviderAiAction::Daemon { .. }) => {
                bail!("daemon is only supported for Codex sessions; use `f codex daemon ...`");
            }
            Some(ProviderAiAction::Memory { .. }) => {
                bail!("memory is only supported for Codex sessions; use `f codex memory ...`");
            }
            Some(ProviderAiAction::Telemetry { .. }) => {
                bail!(
                    "telemetry is only supported for Codex sessions; use `f codex telemetry ...`"
                );
            }
            Some(ProviderAiAction::Trace { .. }) => {
                bail!("trace is only supported for Codex sessions; use `f codex trace ...`");
            }
            Some(ProviderAiAction::ProjectAi { .. }) => {

View on GitHub (pinned to a747e741ae)

Solutions

Run `f codex enable-global` to enable global Codex support
Note that global enablement is a Codex-specific concept; there is no Cursor equivalent
Correct setup scripts that parameterize the provider name for this subcommand

Example fix

// before
$ f cursor enable-global
// error: global Codex enablement is only supported for Codex sessions
// after
$ f codex enable-global

Defensive patterns

Strategy: validation

Validate before calling

fn assert_codex_for_enable_global(provider: &Provider) -> Result<()> {
    if *provider != Provider::Codex {
        bail!("enable-global requires the codex provider");
    }
    Ok(())
}

Type guard

fn supports_enable_global(p: &Provider) -> bool { matches!(p, Provider::Codex) }

Try / catch

if let Err(e) = run_provider(Provider::Cursor, Some(ProviderAiAction::EnableGlobal { .. })) {
    if e.to_string().contains("global Codex enablement") {
        eprintln!("use: f codex enable-global");
    }
}

Prevention

Run global enablement as `f codex enable-global` (Codex-only concept)
Do not template this subcommand with other provider names
Check setup docs for provider-specific setup steps

When it happens

Trigger: Running `f cursor enable-global ...` with any enable-global flags.

Common situations: Setting up global Codex integration but invoking the wrong provider subcommand; setup scripts templated on provider names.

Related errors

AI-assisted analysis of nikivdev/code@a747e741ae (2026-09-01). Data as JSON: /api/errors/95c3d0b86ec2ccc7. Report an issue: GitHub.