CLI Reference

The syn CLI provides commands for managing workflows, agents, and the Syntropic137 platform from your terminal.

Installation

The CLI is included when you install Syntropic137:

uv sync
syn --help

Command	Description
`syn health`	Check API server health status.
`syn run`	Execute a workflow (shortcut for 'syn workflow run').
`syn version`	Show version information.

Group	Description
`syn agent`	AI agent management and testing
`syn artifacts`	Browse and retrieve workflow artifacts
`syn config`	Configuration management
`syn control`	Control running executions
`syn conversations`	Inspect agent conversation logs
`syn costs`	View cost tracking data for sessions and executions
`syn events`	Query domain events and session observability
`syn execution`	List and inspect workflow executions
`syn insights`	Global system insights and cost analysis
`syn marketplace`	Manage workflow marketplace registries.
`syn metrics`	View aggregated workflow and session metrics
`syn observe`	Observability data for sessions — tool timelines and token metrics
`syn org`	Manage organizations
`syn repo`	Manage repositories and their observability
`syn sessions`	View and inspect agent sessions
`syn system`	Manage systems and their observability
`syn triggers`	Manage self-healing trigger rules
`syn watch`	Watch live execution or activity streams
`syn workflow`	Manage workflows - create, list, run, and inspect

Option	Description
`--help`	Show help message