Running agents & workflows

The CLI runs agents and workflows directly from the terminal — just like the Studio playground. Both agent run and workflow run share the same input and execution-mode model.

Interactive mode

Run without parameters and the CLI fetches the available inputs and prompts you for each one:

$ machina workflow run assistant-tools-event-matcher

  Workflow: assistant-tools-event-matcher
  Tool for matching events to markets

  Available inputs: (press Enter to skip)

  competitionIds:
  externalSeasonId: sr:season:123
  limit (default: 50): 10
  market_id:

  Running workflow: assistant-tools-event-matcher
  externalSeasonId=sr:season:123
  limit=10

  Executing workflow...

Inline mode

Pass parameters directly as key=value pairs:

machina agent run my-agent season_id=sr:season:123 force=true
machina workflow run my-workflow limit=10 market_id=abc

Execution modes

Flag	Agent default	Workflow default	Behavior
(none)	async	sync	Agent schedules; workflow waits
--sync	sync	sync	Wait for the result
--async	async	async	Schedule and return
--watch	poll 3s	poll 3s	Watch until complete

machina agent run my-agent --watch                # run and watch progress
machina workflow run my-workflow --async --watch  # schedule, then watch
machina agent run my-agent --sync                 # wait for the full result

INFO

Agents default to async (they schedule and return a run id); workflows default to sync (they wait for the result). Use the flags above to override either default.

See also

• workflow — all subcommands and flags.
• agent — all subcommands and flags.