mco-cli

MCO CLI Skill

Use this Skill when an upstream Agent needs to dispatch one task to one or more coding Agents and preserve their raw operational answers.

Before execution

Confirm the provider/model team with the user in natural language. Do not infer consent from installed binaries. Use either:

• --agent [alias=]provider:model once per invocation; or
• --providers provider,... for one default-model invocation per provider.

--agent is the model-qualified form. It supports repeated models from one provider when each repeated invocation has a distinct alias:

mco run --repo . --prompt "Inspect the parser." \
  --agent fast=pi:fast-model \
  --agent careful=pi:careful-model \
  --result-mode stdout

--providers pi,codex is an invocation-native shorthand. MCO resolves each provider's configured/default model and runs the resulting invocations through the same runtime; it is not a legacy execution path.

If MCO returns provider_selection_required, ask the user which Agents to use and retry with an explicit --providers or --agent selection.

Execution defaults

• mco run defaults to --execution-mode write.
• mco review is a thin read-only preset and defaults to --execution-mode read_only.
• Review passes the explicit prompt unchanged. With no prompt, it uses a short natural-language review prompt; it does not inject a findings schema.
• Use --execution-mode yolo only after the user explicitly requests unrestricted execution.

Output and status

MCO returns raw Agent answer text plus operational metadata. It does not infer findings, severity, confidence, consensus, or decisions from answer prose.

• Default text mode streams answer deltas to stdout. With multiple invocations it adds source labels between answers but does not rewrite answer content.
• --json prints one final JSON envelope.
• --stream jsonl prints JSONL events; each invocation's output_delta values concatenate to its formal answer.
• Progress, warnings, and provider diagnostics go to stderr. stdout remains answer text or the selected machine protocol.
• status is complete, partial, or failed; exit codes are 0, 1, and 2 respectively. A cancelled or timed-out invocation is recorded inside the corresponding task status.