> ## Documentation Index
> Fetch the complete documentation index at: https://docs.entire.io/llms.txt
> Use this file to discover all available pages before exploring further.

# sessions

> View and manage agent sessions tracked by Entire.

View and manage agent sessions tracked by Entire.

```bash theme={null}
entire session SUBCOMMAND
```

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

## session current

Show the most recently active session for the current worktree.

```bash theme={null}
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.

```bash theme={null}
entire session list [flags]
```

For active sessions only, use [`entire status`](/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.

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
entire session attach SESSION_ID [flags]
```

For flags and examples, see the [attach command reference](/cli-reference/attach).

## session adopt

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

```bash theme={null}
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.

```bash theme={null}
entire session resume [BRANCH] [flags]
```

For flags and examples, see the [resume command reference](/cli-reference/resume).