jazzyalex/agent-sessions v4.6.2

Agent Sessions 4.6.2

on GitHub

What's New in 4.6.2

Highlights:

• Your Codex history rebuilds once, on the first launch after updating. The guardian fix below can only reach sessions that are already indexed by re-reading them, so this release re-derives the metadata for your Codex sessions on first launch. While that runs, Codex sessions are missing from the session list and from search results, then reappear all at once when it finishes — there's no partial fill. A large library takes a while: timed here at about two and a half minutes for 3,300 Codex sessions across 5 GB of transcripts, and proportionally less for smaller histories. Claude sessions are untouched throughout, and the rebuild happens exactly once. If your Codex sessions look like they've vanished right after updating, let it finish.

Features:

• Cowork sessions are labelled as Cowork. Claude's Cowork tasks were already in your history, but they wore the same desk badge as Claude Desktop's Code tab, so there was no way to tell a sandboxed Cowork run from a normal desktop coding session. They now carry their own cowork badge. Renaming a task inside Cowork retitles it here without a reindex, and archiving one puts it behind the same archive filter that already covers Claude Desktop — the transcript's archive strip included.
• Codex's sandboxed tasks get their own badge too. Codex Desktop runs some tasks in a throwaway workspace under ~/Documents/Codex/<date>/<slug>/ instead of a repo you chose. Those sessions used to look identical to ordinary Codex Desktop work; they now carry a work badge, named after Codex's own codex_work_desktop marker rather than borrowing Claude's Cowork name for a different vendor's feature.

Bug Fixes:

• Codex guardian sessions stop duplicating their parent's row. Codex's approval-reviewer subagent ("guardian") sessions used to show up as a second top-level row right next to the session they were reviewing — same title, the same work pill, no sign the two were related. They're now classified as subagents like any other Codex subagent: they nest underneath their parent, and the work pill no longer duplicates onto them. Applying this to sessions you already indexed needs the one-time Codex rebuild described under Highlights.
• Resuming a Codex guardian session no longer resumes its parent. Newer Codex builds recorded a guardian subagent's session id as its parent's rather than its own, so clicking Resume on a guardian row reopened the parent's session. Guardian rows now resume themselves.
• Claude usage recovers in seconds, not minutes. When the Claude CLI refreshes its sign-in while Agent Sessions holds an older cached token, the meter now retries immediately with the fresh token instead of waiting out a multi-minute credential check.
• Rate-limit windows no longer black out the meter. When Anthropic's usage endpoint rate-limits (windows can run tens of minutes), Agent Sessions now switches to the claude.ai web path to keep live numbers flowing instead of sitting on stale data.
• The spinner tells you why. The "reconnecting…" cells in the Quota Meter, menu bar, and footer now say what's actually happening — "rate limited — retrying…" — instead of spinning anonymously.
• Leaked probe sessions are reaped reliably. A hidden Claude probe could survive for days if its tmux socket vanished; the launch sweep now retries and logs instead of silently skipping.

Reminder: What You Got in 4.6:

• Read your Claude subscription usage without the CLI — paste a session cookie. If you don't run the Claude CLI, Agent Sessions reads usage over the web instead. On macOS 14+ Safari stopped handing the claude.ai session to other apps, so that path had quietly become a dead end. Now you paste your claude.ai session cookie once in Settings → Usage Tracking: it's kept in your Keychain, needs no Full Disk Access, and sign-in never leaves your browser. A Test now button confirms it works on the spot.
• Paste-a-cookie web usage for Claude. Settings → Usage Tracking accepts your claude.ai sessionKey (or the whole cookie header) and uses it directly for usage lookups — no Full Disk Access, no scraping. The app only holds the token you hand it, stored in the Keychain. Reading the cookie from Safari is kept as a legacy fallback for anyone it still works for.
• The Web API path stops telling signed-in users to "sign in". When it couldn't find a claude.ai session it advised signing in "at claude.ai (default profile)" — impossible to satisfy on macOS 14/15, where Safari keeps the live cookie in a store apps can't read. The messages are now honest and cause-aware, and point to the fix that actually works: paste your session cookie.
• The Quota Meter's right-click hint stays findable. In On-Demand mode the "Right-click for controls" hint used to show once and never again — but right-click is the only way back to the toolbar, so it now reappears on every hover.

Full release notes: https://github.com/jazzyalex/agent-sessions/releases/tag/v4.6.2