---
title: "codespar sessions"
description: "Inspect and manage sessions"
---

Inspect and manage sessions

3 commands in `@codespar/cli 0.16.0`.

Each one prints what its operation answered. [What a command prints](/docs/cli/reference#what-a-command-prints) has the rule, and [Configuration](/docs/cli/config#what-a-script-gets-when-a-command-fails) has the exit codes and the shape of a failure.

### `codespar sessions list`

List recent sessions

```bash
codespar sessions list [options]
```

| option | what it does |
|---|---|
| `--status <s>` | Filter by status: active, closed, error |
| `--limit <n>` | Max results (default 50) |

### `codespar sessions show`

Show a session's details

```bash
codespar sessions show [options] <id>
```

| option | what it does |
|---|---|
| `--logs` | Also include tool-call logs |

### `codespar sessions close`

Close an active session

```bash
codespar sessions close [options] <id>
```