# syn repo
> "Manage repositories and their observability"

Manage repositories and their observability

## `syn repo activity`

Show recent execution activity for a repo.

```bash
syn repo activity <repo_id>
```

**Arguments:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `repo_id` | `text` | Yes | Repo ID |

**Options:**

| Flag | Type | Default | Description |
|------|------|---------|-------------|
| `--limit` | `integer` | `50` | Max entries |
| `--offset` | `integer` | `0` | Pagination offset |

---

## `syn repo assign`

Assign a repo to a system.

```bash
syn repo assign <repo_id> --system <system>
```

**Arguments:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `repo_id` | `text` | Yes | Repo ID |

**Options:**

| Flag | Type | Default | Description |
|------|------|---------|-------------|
| `--system`, `-s` | `text` | --- | System ID |

---

## `syn repo cost`

Show cost breakdown for a repo.

```bash
syn repo cost <repo_id>
```

**Arguments:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `repo_id` | `text` | Yes | Repo ID |

---

## `syn repo failures`

Show recent execution failures for a repo.

```bash
syn repo failures <repo_id>
```

**Arguments:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `repo_id` | `text` | Yes | Repo ID |

**Options:**

| Flag | Type | Default | Description |
|------|------|---------|-------------|
| `--limit` | `integer` | `50` | Max failures to show |

---

## `syn repo health`

Show health metrics for a repo.

```bash
syn repo health <repo_id>
```

**Arguments:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `repo_id` | `text` | Yes | Repo ID |

---

## `syn repo list`

List registered repositories.

```bash
syn repo list
```

**Options:**

| Flag | Type | Default | Description |
|------|------|---------|-------------|
| `--org`, `-o` | `text` | --- | Filter by organization ID |
| `--system`, `-s` | `text` | --- | Filter by system ID |
| `--unassigned` | `boolean` | `false` | Only repos without a system |

---

## `syn repo register`

Register a repository with an organization.

```bash
syn repo register --org <org> --url <url>
```

**Options:**

| Flag | Type | Default | Description |
|------|------|---------|-------------|
| `--org`, `-o` | `text` | --- | Organization ID |
| `--url`, `-u` | `text` | --- | Full repo name (owner/repo) |
| `--system`, `-s` | `text` | --- | Assign to system immediately |
| `--provider` | `text` | `github` | Provider (github, gitlab, …) |
| `--branch` | `text` | `main` | Default branch |
| `--private` | `boolean` | `false` | Private repo |
| `--created-by` | `text` | `cli` | Creator identifier |

---

## `syn repo sessions`

Show agent sessions associated with a repo.

```bash
syn repo sessions <repo_id>
```

**Arguments:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `repo_id` | `text` | Yes | Repo ID |

**Options:**

| Flag | Type | Default | Description |
|------|------|---------|-------------|
| `--limit` | `integer` | `50` | Max sessions to show |

---

## `syn repo show`

Show repo details.

```bash
syn repo show <repo_id>
```

**Arguments:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `repo_id` | `text` | Yes | Repo ID |

---

## `syn repo unassign`

Remove a repo from its system.

```bash
syn repo unassign <repo_id>
```

**Arguments:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `repo_id` | `text` | Yes | Repo ID |

---