# tanomis session

Reference for tanomis session: run, observe, stop, and reap runtime sessions.

Generated from the <code>tanomis</code> command tree on 2026-10-01. Flags and defaults match the binary; run <code>tanomis session --help</code> for the version you have installed.

## Usage

```text title="Usage"
tanomis session
```

## Description

Run, observe, stop, and reap runtime sessions.

## Commands

| Command | Description |
|---|---|
| [`tanomis session file`](/cli/session/file) | manage files in an existing session |
| [`tanomis session get`](/cli/session/get) | show one session |
| [`tanomis session ls`](/cli/session/ls) | list sessions |
| [`tanomis session run`](/cli/session/run) | invoke an agent: create a session, start a run, and stream its output |
| [`tanomis session stop`](/cli/session/stop) | stop a running session |

<details>
<summary>Global flags</summary>

| Flag | Type | Description |
|---|---|---|
| `--config` | string | Config file path. |
| `--context` | string | Config context to use. |
| `-o`, `--output` | string | Output format: table\|json. |
| `--tenant` | string | Tenant id (X-Tenant-ID). |
| `--verbose` | bool | Verbose output. |

</details>