syn workflow

Manage workflows - create, list, run, and inspect

`syn workflow create`

Create a new workflow

syn workflow create <name> [options]

Arguments:

Name	Type	Required	Description
`name`	`text`	Yes	Name of the workflow

Options:

Flag	Type	Default	Description
`--type`, `-t`	`text`	`custom`	Workflow type (research, planning, implementation, review, deployment, custom)
`--repo`, `-r`	`text`	---	Repository URL
`--ref`	`text`	`main`	Repository ref/branch
`--description`, `-d`	`text`	---	Workflow description
`--repos`, `-R`	`text`	---	Default GitHub URLs for workspace hydration (repeatable). ADR-058.
`--no-repos`	`boolean`	`false`	Mark workflow as not requiring repository access (ADR-058 #666)
`--from`, `-f`	`text`	---	Upload a YAML workflow definition. Every semantic field comes from the file - do not combine with --repo/--ref/--type/--description/--repos/--no-repos.

`syn workflow delete`

Archive (soft-delete) a workflow

syn workflow delete <workflow-id> [options]

Arguments:

Name	Type	Required	Description
`workflow-id`	`text`	Yes	Workflow ID (partial match supported)

Options:

Flag	Type	Default	Description
`--force`, `-f`	`boolean`	`false`	Skip confirmation prompt

`syn workflow export`

Export a workflow as a distributable package or Claude Code plugin

syn workflow export <workflow-id> [options]

Arguments:

Name	Type	Required	Description
`workflow-id`	`text`	Yes	Workflow ID to export

Options:

Flag	Type	Default	Description
`--format`, `-f`	`text`	`package`	Export format: 'package' (default) or 'plugin'
`--output`, `-o`	`text`	---	Output directory (default: ./<workflow-slug>-export)
`--force`	`boolean`	`false`	Overwrite existing files without error

`syn workflow info`

Show details of a marketplace workflow plugin

syn workflow info <name>

Arguments:

Name	Type	Required	Description
`name`	`text`	Yes	Plugin name from marketplace

`syn workflow init`

Scaffold a new workflow package from a template

syn workflow init <directory> [options]

Arguments:

Name	Type	Required	Description
`directory`	`text`	Yes	Directory to scaffold (defaults to current dir)

Options:

Flag	Type	Default	Description
`--name`, `-n`	`text`	---	Workflow name
`--type`, `-t`	`text`	`custom`	Free-form workflow type label (e.g. research, planning, custom, code-quality)
`--phases`	`text`	`3`	Number of phases
`--multi`	`boolean`	`false`	Scaffold multi-workflow plugin

`syn workflow install`

Install workflow(s) from a package, git repository, or marketplace

syn workflow install <source> [options]

Arguments:

Name	Type	Required	Description
`source`	`text`	Yes	Plugin name, local path, GitHub URL, or org/repo shorthand

Options:

Flag	Type	Default	Description
`--ref`	`text`	`main`	Git branch/tag to clone
`--dry-run`, `-n`	`boolean`	`false`	Validate without installing

`syn workflow list`

List all workflows

syn workflow list [options]

Options:

Flag	Type	Default	Description
`--include-archived`	`boolean`	`false`	Include archived workflows

`syn workflow packages`

List workflow packages pulled from the marketplace (local CLI history; use 'syn workflow list' to see what is currently on the running stack)

syn workflow packages

`syn workflow run`

Execute a workflow

syn workflow run <workflow-id> [options]

Arguments:

Name	Type	Required	Description
`workflow-id`	`text`	Yes	Workflow ID (partial match supported)

Options:

Flag	Type	Default	Description
`--input`, `-i`	`text`	---	Input variables as key=value
`--task`, `-t`	`text`	---	Primary task description ($ARGUMENTS)
`--repo`, `-R`	`text`	---	Repository to pre-clone (repeatable). Accepts owner/repo, full GitHub URL, or syn repo-* ID.
`--dry-run`, `-n`	`boolean`	`false`	Validate without executing
`--quiet`, `-q`	`boolean`	`false`	Minimal output

`syn workflow search`

Search for workflows across registered marketplaces

syn workflow search <query> [options]

Arguments:

Name	Type	Required	Description
`query`	`text`	Yes	Search term (matches name, description, tags)

Options:

Flag	Type	Default	Description
`--category`, `-c`	`text`	---	Filter by category
`--tag`, `-t`	`text`	---	Filter by tag
`--registry`, `-r`	`text`	---	Search specific marketplace only

`syn workflow show`

Show details of a workflow

syn workflow show <workflow-id>

Arguments:

Name	Type	Required	Description
`workflow-id`	`text`	Yes	Workflow ID (partial match supported)

`syn workflow status`

Show execution history for a workflow

syn workflow status <workflow-id>

Arguments:

Name	Type	Required	Description
`workflow-id`	`text`	Yes	Workflow ID (partial match supported)

`syn workflow uninstall`

Uninstall a workflow package

syn workflow uninstall <name> [options]

Arguments:

Name	Type	Required	Description
`name`	`text`	Yes	Package name to uninstall

Options:

Flag	Type	Default	Description
`--keep-workflows`	`boolean`	`false`	Remove from registry but keep workflows in the platform

`syn workflow update`

Update an installed workflow package to the latest version

syn workflow update <name> [options]

Arguments:

Name	Type	Required	Description
`name`	`text`	Yes	Package name to update

Options:

Flag	Type	Default	Description
`--ref`	`text`	---	Override git ref
`--dry-run`, `-n`	`boolean`	`false`	Check for updates without applying

`syn workflow validate`

Validate a workflow YAML file or package directory

syn workflow validate <file>

Arguments:

Name	Type	Required	Description
`file`	`text`	Yes	YAML file or package directory

On this page