Skip to content

FEAT: display session names in terminal and web Sessions - #64

Merged
merefield merged 5 commits into
mainfrom
feat/session-names
Sep 20, 2026
Merged

merefield merged 5 commits into
mainfrom
feat/session-names

Conversation

@merefield

@merefield merefield commented Sep 20, 2026

Copy link
Copy Markdown
Owner

Session rows were identified only by an abbreviated session ID and directory, making named Codex sessions harder to recognise. Named sessions now show short session ID // name in the left telemetry box border, with their directory inside the box beneath model information when space permits. Unnamed sessions retain the existing ID/directory title.

The web interface uses the same local names in selectable session headings, keeps the directory inside the panel, and identifies named sessions on full detail. This is available in read-only and writable browser modes.

Attention pills use the matching session ID and name (directory fallback), retaining the ID when terminal pills compress. Highlighted row status labels are clickable links to that session's native detail in both terminal and browser interfaces.

Names are read from Codex's local session index, cached until the file changes, and refreshed after renames. This works without shared-daemon mode. Display text is sanitised, and unavailable name metadata does not fail token polling. Session status and token/model metrics retain priority in short rows.

Validation: the Codex and terminal test suites passed, with targeted tests for name lookup, renames, index replacement, row sizing and directory placement. The existing English presentation snapshot passes. Local binary rebuilt and README updated.

Web validation: Svelte/type/format checks and production build passed, plus all 41 browser tests, including named-session display, pill identity, clickable status navigation, full detail, responsive navigation and safe text rendering. All Go packages pass. Embedded assets and local binary rebuilt.

@merefield merefield changed the title FEAT: display session names in Sessions telemetry FEAT: display session names in terminal and web Sessions Sep 20, 2026
@merefield
merefield requested a lite review from Copilot September 20, 2026 17:33

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

Short terminal rows can omit session status because the optional directory is inserted before the fallback status.

Get a fresh assessment by requesting another Copilot review.

Review effort: Lite
Findings: 1 Medium severity

Open (1)
What changed in this PR

Adds local Codex session-name lookup and displays names in terminal and web session views.

Changes:

  • Added cached name-index reading with rename refresh.
  • Updated terminal/web session rendering and accessibility labels.
  • Added tests, documentation, and rebuilt web assets.
File Description
internal/​codex/​session_names.go Reads and sanitizes session names.
internal/​codex/​live_usage.go Propagates names into live snapshots.
internal/​ui/​monitor.go Displays names in terminal telemetry.
internal/​ui/​model.go Tracks names through monitor state.
web/​src/​Sessions.svelte Displays names in session rows/details.
web/​src/​state.svelte.ts Adds the session name type.
internal/​web/​state.go Projects sanitized names to web clients.
internal/​codex/​session_names_test.go Tests rename/index behavior.
internal/​ui/​monitor_name_test.go Tests terminal name rendering.
web/​tests/​browser.spec.ts Tests named-session web flows.
README.md Documents named-session display.
internal/​web/​dist/​index.html References rebuilt assets.
internal/​web/​dist/​assets/​index-BZfqFWbz.js Contains rebuilt web bundle.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread internal/ui/monitor.go Outdated

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

Attention pills omit the valid named-session label . because directory fallback filtering is applied to names.

Get a fresh assessment by requesting another Copilot review.

Review effort: Lite
Findings: 1 Medium severity

Open (1)
Resolved since last review (1)

Comment thread internal/ui/monitor_summary.go Outdated
@merefield
merefield merged commit 2779d02 into main Sep 20, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants