Agent Sessions

CodexBar can list live Codex and Claude Code sessions on this Mac and other Macs or Linux hosts reachable over SSH.

Enable Settings → Menu → Agent sessions. Local sessions refresh every 30 seconds. Remote sessions refresh every 60 seconds and whenever the menu opens. Tailscale discovery includes online macOS and Linux peers; add extra SSH destinations as a comma-separated list, such as user@host.

Choose the row label format in the same settings section:

Project keeps the working-directory name used by earlier releases.
Descriptive uses the Codex thread title or named subagent task, with the project as a fallback.
Descriptive + project shows both when they differ.

Thread titles can contain sensitive text. Project remains the default; choose a descriptive mode only if you are comfortable showing those titles in the menu. CodexBar reads title metadata without modifying Codex state and does not persist it to disk.

Claude Code sessions currently fall back to the project name because Claude does not expose equivalent session-title metadata.

The menu groups local sessions first, followed by each remote host. A filled dot is active; an empty dot is idle. Select a local row to activate its terminal, editor, or desktop app. The first focus attempt can request macOS Accessibility permission so CodexBar can raise the matching window. Remote rows run the same focus command over SSH.

The CLI exposes the same scanner:

console

codexbar sessions
codexbar sessions --json
codexbar sessions focus <session-id>

Remote hosts need key-based, non-interactive SSH and either codexbar on PATH or CodexBar installed in /Applications.