[KongchangAI]
· 1 min read· 905 words

AgentValley: See All Your Claude Code Agents at a Glance in the Mac Notch

AgentValley: See All Your Claude Code Agents at a Glance in the Mac Notch

AgentValley projects Claude Code session and sub-agent status onto the Mac notch, enabling at-a-glance monitoring with cards and pixel avatars.

AgentValley is an open-source, free Mac menu bar tool whose core idea is to bring multiple Claude Code sessions and sub-agent statuses into the MacBook notch area. Each session corresponds to a card, each sub-agent to a row, accompanied by a pixel programmer figure that visually shows who's working, which model they're using, and who's waiting for input. It addresses the pain point of status being scattered across terminals during parallel multi-agent work, making it hard to identify quickly, and replaces plain text logs with a visualized dashboard-style interface. The tool is lightweight, always running, and doesn't occupy the main screen—ideal for developers already accustomed to menu bar tools. Limitations include compatibility only with notch-equipped Macs, and as an early-stage project, its feature depth and stability still need validation, with fairly limited community feedback.

AgentValley: See All Your Claude Code Agents at a Glance in the Mac Notch

If you're running multiple Claude Code sessions at once, do you often struggle to tell which agent is actually working and which is waiting for your input? AgentValley tries to solve this pain point with a single notch. This open-source tool, which earned 98 votes and ranked 4th on Product Hunt, turns each Claude Code session into a card, each sub-agent into a row, and throws in a pixel-art programmer to boot.

The Notch Becomes an Agent Monitoring Console

AgentValley's core design is remarkably straightforward: it lives in the MacBook's notch. Each Claude Code session generates a card, and each sub-agent under a session maps to a row. The interface features a pixel-style programmer avatar that visually indicates who's working, which model they're using, and who's waiting for your input.

This design moves status that was previously buried in the terminal to the top of the screen, letting developers grasp the big picture without switching windows. For scenarios that require handling multiple tasks in parallel, this "visible-at-a-glance" information density is far more efficient than constantly switching between terminal tabs.

The MacBook notch area isn't a canvas where any content can be drawn directly at the system level—it's a physical cutout reserved around the camera module. Third-party apps typically squeeze status information into the narrow space between the menu bar and the notch using MenuBarExtra, NSStatusItem, or overlay windows. AgentValley's ability to live in the notch fundamentally relies on macOS's layout mechanisms for menu bar icons and floating windows, rather than actually modifying the hardware cutout. This also explains why it only supports notch-equipped models: different screen geometries require entirely different layout parameters.

Open Source and Free, With a Very Low Barrier to Entry

AgentValley is completely free and open source, with its code hosted on GitHub. It's categorized as a developer tool and menu bar app, meaning it's lightweight, runs in the background, and doesn't take up main screen space. For Mac users already accustomed to managing their development workflow with menu bar tools, it requires almost no change to existing habits.

Its open-source nature also lowers the trust barrier—developers can review the code themselves or even modify it to suit their needs. In an era of rapid iteration in AI coding tools, this openness is more likely to earn recognition from the technical community than closed commercial products.

Solving the Real Pain Point of Multi-Agent Management

Claude Code allows developers to launch multiple sessions and sub-agents to handle coding tasks in parallel, but managing the state of these agents has always been a hassle. AgentValley's value lies in aggregating information scattered across terminals into a unified interface, replacing plain text output with visual representations (cards, rows, pixel avatars).

This approach aligns with the "development environment dashboard" trend that has gained popularity in recent years: treating agent runtime states as metrics that need monitoring, rather than something you can only eyeball through logs. Although it currently only supports Claude Code, this design pattern has the potential to extend to other AI coding agents.

Claude Code's "sessions" and "sub-agents" are two distinct concepts at different levels. A session typically corresponds to an independent terminal process or conversation context, while a sub-agent is an execution unit spawned by the main agent to handle subtasks in parallel, potentially with its own model, context, and state. When multiple sessions each spawn their own sub-agents, the number of states balloons rapidly, and it becomes very difficult to determine from scrolling terminal logs alone who's running and who's waiting for permission confirmation. AgentValley's hierarchical structure of "session cards + sub-agent rows" is precisely designed to map this one-to-many runtime topology.

Limitations Worth Noting

Based on the Product Hunt page information, AgentValley currently only supports Mac devices with a notch, which means Mac models without a notch or users on non-Mac platforms can't use it. Additionally, as an early-stage project, its feature depth and stability still need validation from more users. The community feedback of 4 comments and 98 votes shows it has generated interest, but the sample size remains limited.

For heavy Claude Code users, this is still an efficiency tool worth trying. It doesn't change your workflow—it just lets you glance up and instantly know which agent needs you.


Key Takeaways

  • AgentValley projects Claude Code session and sub-agent status onto the Mac notch, visualized with cards and pixel avatars.
  • Completely free and open source, positioned as a lightweight menu bar tool that doesn't occupy the main screen.
  • Solves the pain point of state monitoring during parallel multi-agent work, with information aggregation that's more intuitive than terminal logs.
  • Currently only compatible with notch-equipped Mac devices; feature depth and stability remain to be validated.
  • The design pattern can be extended to other AI coding agents, but the project is still in its early stages.

Product Hunt vote counts and rankings reflect community exposure on launch day, not long-term adoption. 98 votes, 4th place, and 4 comments represent a small-to-medium sample within the developer tools category, easily influenced by launch timing, community mobilization, and category buzz. For early-stage open-source projects, the more meaningful indicators are usually GitHub issue activity, commit frequency, and release cadence. Only by looking at these signals together can you judge whether a tool is "peak at launch" or has the potential for sustained maintenance.

#AgentValley#Claude Code#Mac notch#menu bar tool#AI coding agents#multi-agent management
Share:

Related articles