Yeachan-Heo/oh-my-codex · error · Error

${EXPLORE_DEPRECATION_MESSAGE}\n\n${EXPLORE_HELP}

Error message

${EXPLORE_DEPRECATION_MESSAGE}\n\n${EXPLORE_HELP}

What it means

The `explore` CLI command has been deprecated/removed; any non-help invocation throws an error containing the deprecation message and help text. This mirrors the autoresearch removal pattern.

Source

Thrown at src/cli/explore.ts:95

    const binaryPath = join(packageRoot, 'bin', binaryName);
    if (!existsSync(binaryPath)) return undefined;
    return { command: binaryPath, args: [] };
  } catch {
    return undefined;
  }
}

function shouldShowHelp(args: readonly string[]): boolean {
  return args.length > 0 && args.every((arg) => arg === '--help' || arg === '-h' || arg === 'help');
}

export async function exploreCommand(args: string[]): Promise<void> {
  if (shouldShowHelp(args)) {
    console.log(EXPLORE_HELP);
    return;
  }

  throw new Error(`${EXPLORE_DEPRECATION_MESSAGE}\n\n${EXPLORE_HELP}`);
}

View on GitHub (pinned to 3ad79a8a6f)

Solutions

1. Run `omx explore --help` to read the replacement guidance
2. Migrate to the replacement command named in EXPLORE_DEPRECATION_MESSAGE
3. Update wrappers/capture scripts that call exploreCommand
4. Pin the older CLI version as a temporary workaround

Example fix

# before
omx explore ./src

# after
omx explore --help  # follow the suggested replacement command

const HELP_ONLY = new Set(['--help', '-h']);
if (!args.every(a => HELP_ONLY.has(a))) {
  throw new Error('explore command is deprecated; use its replacement');
}

try {
  await exploreCommand(args);
} catch (e) {
  console.error((e as Error).message); // includes replacement guidance
  process.exitCode = 1;
}

When it happens

Trigger: Running `omx explore <args>` with anything other than help flags; calling `exploreCommand(args)` programmatically (it is also invoked by `captureExploreCommand`).

Common situations: Post-upgrade breakage where scripts or integrations still call explore; automation built on an older CLI version.

Related errors

• ${AUTORESEARCH_DEPRECATION_MESSAGE}\n\n${AUTORESEARCH_HELP}
• [explore] ${reason}
• Deprecated usage: `omx team ralph ...` has been removed. Use
• Unknown adapt argument: ${arg}
• Unknown adapt target: ${target}. Supported targets: ${suppor

AI-assisted analysis of Yeachan-Heo/oh-my-codex@3ad79a8a6f (2026-08-27). Data as JSON: /api/errors/9f3662fcd28316b2. Report an issue: GitHub.