Skip to main content

​
Usage

archal scenario <subcommand> [options]

​
Subcommands

​
scenario list

List local scenarios and hosted catalog scenarios. 
archal scenario list
archal scenario list --clone github
archal scenario list --tag financial-controls
archal scenario list --page 2 --limit 10
archal scenario list --json
FlagDescriptionDefault
--clone <name>Filter scenarios by required cloneall
--tag <tag>Filter scenarios by catalog tagall
--source <kind>Filter by source: local, workspace, sample, hosted, allall
--page <n>Page number for text output1
--limit <n>Scenarios per page for text output20
--jsonOutput all matching rows as JSONfalse
Shows each scenario’s title, slug, description, source (local file, workspace, sample, or hosted catalog), and required clones.

​
scenario push

Save a local scenario to the active workspace so other projects in the same workspace can reuse it. Scenarios are not auto-saved on archal run - this command is the canonical way to share a scenario across projects. 
archal scenario push ./scenarios/close-stale-issues.md
archal scenario push ./scenarios/close-stale-issues.md --set-default
FlagDescription
--workspace <id>Workspace id (defaults to the active workspace)
--title <title>Override the scenario title stored in the workspace
--harness <path>Default harness path to store with this scenario
--replace <id-or-slug>Update an existing workspace scenario instead of creating one
--set-defaultMake the pushed scenario the workspace default
--jsonOutput the saved scenario as JSON