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

${AUTORESEARCH_DEPRECATION_MESSAGE}\n\n${AUTORESEARCH_HELP}

Error message

${AUTORESEARCH_DEPRECATION_MESSAGE}\n\n${AUTORESEARCH_HELP}

What it means

The `autoresearch` CLI command has been removed/deprecated in this version of the tool. Any invocation that is not a help request (`--help`/`-h`) immediately throws, with the deprecation message and help text bundled into the error. This is a hard removal guard, not a runtime failure.

Source

Thrown at src/cli/autoresearch.ts:110

    return { missionDir: values[1]?.trim() || null, runId: null, codexArgs: values.slice(2), runSubcommand: true };
  }
  if (first.startsWith('-')) {
    return { missionDir: null, runId: null, codexArgs: [], guided: true, seedArgs: parseInitArgs(values) };
  }
  return { missionDir: first, runId: null, codexArgs: values.slice(1) };
}

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

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

  throw new Error(`${AUTORESEARCH_DEPRECATION_MESSAGE}\n\n${AUTORESEARCH_HELP}`);
}

View on GitHub (pinned to 3ad79a8a6f)

Solutions

1. Run the command with --help or -h to print help text instead of throwing
2. Check the deprecation/help text in the error message for the replacement command and migrate to it
3. Update scripts and CI configs to stop invoking autoresearch
4. Pin to an older version of the CLI if you temporarily still need autoresearch

Example fix

# before
omx autoresearch --topic x

# after
omx autoresearch --help   # see the recommended replacement in the help text

import { autoresearchCommand } from './src/cli/autoresearch';
const HELP_ONLY = new Set(['--help', '-h']);
const isSafe = (args: string[]) => args.length === 0 || args.every(a => HELP_ONLY.has(a));
if (!isSafe(myArgs)) throw new Error('autoresearch is deprecated; use the replacement command');

try {
  await autoresearchCommand(args);
} catch (e) {
  // Deprecated command always throws; surface help text and migrate.
  console.error((e as Error).message);
  process.exitCode = 1;
}

When it happens

Trigger: Running `omx autoresearch <anything>` (any args other than help flags) via the CLI entrypoint; calling `autoresearchCommand(args)` programmatically with non-help args.

Common situations: Scripts, CI pipelines, or shell aliases still calling the autoresearch command after upgrading to a version where the feature was removed; docs or tutorials referencing the old command.

Related errors

• --keep-policy must be one of: score_improvement, pass_only
• ${EXPLORE_DEPRECATION_MESSAGE}\n\n${EXPLORE_HELP}
• Deprecated usage: `omx team ralph ...` has been removed. Use
• No autoresearch-goal mission found at ${repoRelative(cwd, pa
• Invalid autoresearch-goal mission at ${repoRelative(cwd, pat

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