syn workflow

Manage workflows - create, list, run, and inspect

`syn workflow create`

Create a new workflow.

syn workflow create <name>

Arguments:

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

Options:

Flag	Type	Default	Description
`--type`, `-t`	`text`	`custom`	Type: research, planning, implementation, review, deployment, custom
`--repo`, `-r`	`text`	`https://github.com/example/repo`	Repository URL for the workflow
`--ref`	`text`	`main`	Repository ref/branch
`--description`, `-d`	`text`	---	Workflow description

`syn workflow delete`

Archive (soft-delete) a workflow template.

Archived workflows are hidden from 'syn workflow list' by default. Use 'syn workflow list --include-archived' to see them.

syn workflow delete <workflow_id>

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>

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' (Claude Code plugin)
`--output`, `-o`	`path`	`.`	Output directory (created if absent)

`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>

Arguments:

Name	Type	Required	Description
`directory`	`path`	No	Directory to scaffold

Options:

Flag	Type	Default	Description
`--name`, `-n`	`text`	---	Workflow name
`--type`, `-t`	`text`	`research`	Workflow type
`--phases`	`integer`	`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>

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 installed`

List installed workflow packages.

syn workflow installed

`syn workflow list`

List all workflows in the system.

syn workflow list

Options:

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

`syn workflow run`

Execute a workflow.

syn workflow run <workflow_id>

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)
`--dry-run`, `-n`	`boolean`	`false`	Validate without executing
`--quiet`, `-q`	`boolean`	`false`	Minimal output
`--container`, `-c`	`boolean`	`true`	Run in isolated container
`--tenant`	`text`	---	Tenant ID for multi-tenant attribution

`syn workflow search`

Search for workflows across registered marketplaces.

syn workflow search <query>

Arguments:

Name	Type	Required	Description
`query`	`text`	No	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 specific 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>

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>

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 without creating it.

syn workflow validate <file>

Arguments:

Name	Type	Required	Description
`file`	`path`	Yes	YAML file or package directory to validate

On this page