06. Sessions

Session metadata

Inspect the current session without leaving the TUI: title, ID, model, working directory, and how much of the context window is used.

Open session info

/session-info

Aliases: /status, /info.

All three open the same view. The command is session-scoped and instant (not queued). Without an active session you get **No active session**.

The panel is the usage / session-info modal, opened on the **Session info** tab. /usage is a sibling tab for local token usage, not a second session inspector.

What it shows

Typical fields:

Field	Meaning
Title	Present when the session has a title (`/rename`)
Shell version	Matcha CLI version string
Auth method	How this process is authenticated
Session ID	ID to pass to `matcha --resume`, `matcha export`, or `matcha sessions delete`
Working directory	Cwd stored with the session
Model	Active model (display name; a model hash appears for coding models)
API backend	When the session recorded one
Sandbox	Current sandbox profile, when set
Turn	Turn index
Context	Used / total tokens and the percentage used

Auth in this version is a **Provider API key (BYOK)** — from the Provider vault or from an env var. The text may tell you to run matcha login --provider <id> to rotate a key. There is no MatchaCode account and no product OAuth.

A **Conversation ID** line appears only when the session stored one. Remote conversation sync is disabled; you do not need that ID for local resume or export.

When to use it

Copy the **Session ID** before matcha export or matcha -r.
Check **Context** when the model starts forgetting early turns — then /compact or /context.
Confirm **Working directory** if resume picked an unexpected project.
Confirm **Model** after /model.

/context is the detailed breakdown (categories and estimates). /session-info is the one-screen identity card.