Agent Session Status

agent-session-status

[](https://github.com/dcaixinha/agent-session-status/actions/workflows/ci.yml) [](LICENSE)

Live OpenCode, Claude Code, and Codex session state for Ironbar and Waybar. Provider events are reduced to a small local state store, so the bar can show active work, requests that need attention, and completed turns without scraping terminal output.


*Three local provider segments using the bundled OpenCode image and text-only Claude Code and Codex labels.*


*The OpenCode session popup, including project paths and resolved Hyprland workspace labels.*

Features

• Event-driven local updates for multiple simultaneous sessions and subagents.
• Clear priority: waiting > working > idle. Any pending permission, question, or elicitation makes a session effectively waiting, regardless of its stored status.
• Compact aggregation: (N) means all N visible main sessions share the displayed state; (highest/N) means the numerator is the number in the highest displayed state out of N main sessions; +N counts non-idle subagents.
• Main sessions remain visible while idle. Subagents are visible only while working or waiting.
• Ironbar popups and Waybar tooltips with project paths and optional Hyprland workspace labels.
• Theme-aware OpenCode images, user-supplied provider images, configurable status glyphs and colors, optional local SVG tinting, and grouped remote sources.
• Opt-in desktop and audio alerts for exact transitions to idle.

Contents

• Quick Start
• Arch Linux (AUR)
• Providers