# CLI Reference
> Command-line interface for Syntropic137.

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:

```bash
uv sync
syn --help
```

## Global Commands

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

## Command Groups

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

## Global Options

| Option | Description |
|--------|-------------|
| `--help` | Show help message |