InteractiveCommandAgents & delegated specialistsAgent runs

/agents run <AGENT> <TASK>

Agents Run/code/commands/interactive/agents-run

Run agents.

Options
5
Arguments
2
Examples
2
Industry
0 of 5 mapped

About

Supported options and rules: --background; --model MODEL; --effort LEVEL; --worktree; --environment ENV.

Syntax

The canonical syntax string as recorded in the catalogue. It is authoritative — it is never reconstructed from the option and argument lists below.

/agents run <AGENT> <TASK>

Subcommand of /agents

Arguments

  • agentidentifierRequiredposition 1

    Agent profile name or identifier.

  • taskstringRequiredposition 2

    Task description.

Options

Defaults, allowed values, conflicts and scope come from the catalogue; blank fields mean the catalogue records nothing, not that the constraint is absent.

  • --backgroundbooleanOptional

    Run the delegated agent asynchronously in the background. Default: False.

    Defaultfalse
  • --model <string>stringOptional

    Override the model used for this invocation or delegated run.

  • --effort <enum>enumOptional

    Override the reasoning-effort level. Allowed values: auto, low, medium, high, xhigh.

    Allowedauto, low, medium, high, xhigh
  • --worktreebooleanOptional

    Use an isolated Git worktree for the invocation or agent run. Default: False.

    Defaultfalse
  • --environment <identifier>identifierOptional

    Choose the execution environment for delegated work.

Examples

  • With options

    WITH OPTIONS
    /agents run reviewer "review selector changes" --background

    Run agents.

  • Representative options

    WITH OPTIONS
    /agents run reviewer "review selector changes" --background --model auto

    Shows representative optional controls available for this command.

Availability & requirements

Nothing recorded — this command is offered in the default session, with no repository, authentication, capability or platform requirement attached to it.

Relationships

Aliases

None recordedNo alias resolves to this command

Alternate surfaces

Not applicableThis command exists on one surface only

Related commands

None recordedNo related command is recorded

Industry comparison

0 of 5 products mapped

Command-level mappings against 5 audited products, each with its documentation source and capture date. No documented equivalent means the audit found nothing in that product’s official documentation — it is not a claim that the product lacks the capability.

Every canonical command was reviewed against all 5 products in one pass captured 2026-09-18. A product with no mapping is a reviewed finding of no documented equivalent, not an unreviewed pair.

Captured 2026-09-18 · 238 commands × 5 products

All 5 results below are negative. That is this command’s reviewed finding — not an incomplete row.

Open in Compare →