## Session Management

View and manage agent sessions tracked by Entire.

```
entire session SUBCOMMAND
```

`entire session` is also available as `entire sessions`.

## session current

Show the most recently active session for the current worktree.

```
entire session current [flags]
```

| Flag | Description |
| --- | --- |
| `--json` | Output as JSON |
| `--transcript` | Stream raw agent transcript bytes to stdout |

## session list

List all sessions tracked by Entire, including ended sessions.

```
entire session list [flags]
```

For active sessions only, use [`entire status`](https://docs.entire.io/cli-reference/status).

| Flag | Description |
| --- | --- |
| `--json` | Output as JSON |

## session info

Show detailed information for a specific session. `entire session info` shows agent, model, status, worktree, timing, token usage, checkpoint linkage, and files touched.

```
entire session info SESSION_ID [flags]
```

| Flag | Description |
| --- | --- |
| `--json` | Output as JSON |
| `--transcript` | Stream raw agent transcript bytes to stdout |

## session tokens

Show token usage and optimization recommendations for a session.

```
entire session tokens [SESSION_ID] [flags]
```

When no session ID is provided, Entire reports on the most recently active session for the current worktree.

| Flag | Description |
| --- | --- |
| `--agent-brief` | Output compact next-step guidance for agents |
| `--current` | Prefer the current worktree’s most recent session |
| `--json` | Output as JSON |

## session stop

Stop one or more active sessions.

```
entire session stop [SESSION_ID] [flags]
```

| Flag | Description |
| --- | --- |
| `--all` | Stop all active sessions |
| `-f, --force` | Skip confirmation prompt |

## session attach

Attach an existing agent session that was not captured automatically by Entire.

```
entire session attach SESSION_ID [flags]
```

For flags and examples, see the [attach command reference](https://docs.entire.io/cli-reference/attach).

## session adopt

Adopt an active session from another worktree into the current repository.

```
entire session adopt [SESSION_ID] --from SOURCE_WORKTREE [flags]
```

Use this when an agent starts in one repository or worktree, then moves and makes changes in another.

| Flag | Description |
| --- | --- |
| `--from PATH` | Source worktree that already tracks the session |
| `--force` | Replace an existing local state file for the same session |
| `--yes` | Confirm same-store adoption and replacement without prompting |

## session resume

Resume an agent session from a branch or interactive picker.

```
entire session resume [BRANCH] [flags]
```

For flags and examples, see the [resume command reference](https://docs.entire.io/cli-reference/resume).
