Agenteria

An open-source macOS menu bar app that turns your Claude Code sessions into pizza ovens. One glance answers the question you keep asking: which agent is waiting on you, which one finished ten minutes ago, and which is about to run out of context.

Once you run more than one coding agent at a time, you pay a tax: cycling through terminal windows to find out which one needs you. Agenteria removes it. Every session becomes an oven in the menu bar, and its shape carries its state, so it reads at a glance and survives a screenshot or a colourblind viewer.

• Cooking means the agent is mid-turn.
• Blocked means Claude stopped and is waiting on you.
• Ready means it finished, and has not been reviewed yet.
• Context warns when a session is running low on window.

Click an oven and its terminal comes to the front, the exact tab, not a guess: the hooks report the tty and Terminal.app exposes the same string, so the match is precise.

The argument

A finished session does not quietly disappear. It sits there as a pizza until you actually go back to that terminal and look, because the state that matters is not "the agent said it was done." It is "you have looked at it." Nothing completes silently while you are staring at another window.

That is the same conviction behind everything I build. An agent's own report that it is finished is not the thing worth trusting; a human having actually reviewed the work is. Agenteria just makes that gap impossible to ignore, so review stays mandatory instead of optional.

Install

# macOS, with Claude Code already set up. No dependencies, no sudo.
git clone https://github.com/Whittle777/agenteria.git
cd agenteria && python3 install.py

One Python standard-library server and one Swift file, nothing outside your home directory, and python3 install.py --uninstall reverses all of it.

Open source, MIT. Built and used daily.