Skip to content
Back
Beta· v0.2.0GNOME Extension for Claude Code

AgentBar

Shows what your Claude Code sessions are doing in the GNOME top bar, so you can work in another window and still know when Claude needs you.

[01]Overview

An MIT-licensed Linux desktop tool that monitors multiple Claude Code sessions from the GNOME top bar. The bar shows the session that matters most, its state, and how long ago it last did something. The menu lists every session, and clicking one brings its terminal or editor window to the front.

Challenge

With several Claude Code sessions running in different terminals, the only way to know whether one is waiting for input, needs permission, or failed is to keep checking each window.

Solution

An event-driven design: Claude Code hooks write session events to local JSON state, and a GNOME Shell extension renders it within a second of each event. Notifications fire only when Claude needs permission, is waiting, finishes a turn, or fails. States stay honest: a session with no news for 10 minutes says "No updates" instead of guessing, and a closed terminal reads "Ended".

Tech Stack
TypeScriptNode.jsGNOME ShellGJSLinuxClaude Code Hooks
[02]Demo
Watch on YouTube
[03]Screens
Top-bar menu: sessions, health line, doctor
[04]Impact
  • →Local-first: no account, no server, no telemetry
  • →Packaged for Ubuntu as a .deb installer
  • →Multi-session tracking, desktop notifications, and terminal window navigation
  • →install-hooks with a dry run and settings backup, plus an agentbar doctor diagnostic command