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

Usage: omx team resume <team-name>

Error message

Usage: omx team resume <team-name>

What it means

Thrown by the `omx team resume` subcommand when no team name is passed. Resume reattaches to a previously created team runtime and needs an explicit name to look up resumable state.

Source

Thrown at src/cli/team.ts:1672

    }

    const event = result.event!;
    const context = [
      `team=${resolvedName}`,
      `event=${event.type}`,
      `worker=${event.worker}`,
      event.state ? `state=${event.state}` : '',
      event.prev_state ? `prev=${event.prev_state}` : '',
      event.task_id ? `task=${event.task_id}` : '',
      `cursor=${result.cursor}`,
    ].filter(Boolean).join(' ');
    console.log(context);
    return;
  }

  if (subcommand === 'resume') {
    const name = teamArgs[1];
    if (!name) throw new Error('Usage: omx team resume <team-name>');
    const runtime = await resumeTeam(name, cwd);
    if (!runtime) {
      console.log(`No resumable team found for ${name}`);
      return;
    }
    await ensureTeamModeState({
      task: runtime.config.task,
      workerCount: runtime.config.worker_count,
      agentType: runtime.config.agent_type,
      explicitAgentType: false,
      explicitWorkerCount: false,
      teamName: runtime.teamName,
      displayName: runtime.config.display_name ?? runtime.teamName,
      allowRepoAwareDagHandoff: false,
    });
    const availableAgentTypes = await resolveAvailableAgentTypes(cwd);
    const staffingPlan = buildFollowupStaffingPlan('team', runtime.config.task, availableAgentTypes, {
      workerCount: runtime.config.worker_count,

View on GitHub (pinned to 3ad79a8a6f)

Solutions

1. Run omx team resume <team-name> with the name used at creation
2. List teams to recover the exact name if forgotten
3. Assert the name argument in wrapper scripts before calling omx

Example fix

# before
omx team resume
# after
omx team resume my-team

const [cmd, name] = args;
if (cmd === 'resume' && !name) { console.error('team name required'); process.exit(1); }

When it happens

Trigger: Running `omx team resume` with zero arguments; relying on an implicit 'last team' behavior that does not exist for resume.

Common situations: Users resuming after a shell restart who forget the team name; automation scripts with an unset name variable.

Related errors

• Usage: omx team [N:agent-type] "<task description>"
• Usage: omx team status <team-name> [--json]
• Usage: omx team await <team-name> [--timeout-ms <ms>] [--aft
• Usage: omx team shutdown <team-name> [--force] [--confirm-is
• unknown list option: ${unknown[0]}

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