AgentValley is an open-source macOS status panel designed for Claude Code, living in the MacBook notch or display top to track concurrent agents, prompt approvals, and API usage.
What the product does and how it is positioned
AgentValley is a native macOS application that tracks Claude Code terminal sessions from the screen notch or the top of an external display. It consolidates active sessions and sub-agents into a unified list grouped by project, displaying current steps, running models, and pending user queries.
The tool alerts users when an agent is waiting for permission or input, allowing users to jump directly to the corresponding terminal tab or submit responses directly from the notch. In addition to visual and audio status updates, AgentValley monitors token consumption and enables PDF export of project history.
Source-supported ways to use the product
Developers running several Claude Code sessions across multiple terminals can observe status, current steps, and idle times from a single menu without window switching.
Engineers can review command permission requests and allow or deny them from the notch interface rather than finding the active terminal window.
Teams and individual developers can track historical token consumption across projects and generate PDF statements of work for recordkeeping or client reporting.
AgentValley functions by reading local project and session files generated by Claude Code in the user home directory, alongside process lists and Git repository configurations. This enables the software to correlate running processes with repository branches and remote addresses without altering the source session files.
When users activate terminal enhancements, the tool integrates custom status line elements into Claude Code settings and configures a lightweight avatar font across supported terminal emulators. An optional Claude Code plugin exposes hooks for answering approval prompts directly from the notch panel.
Checks to run with your own material and workflow
What was checked and when
Answers based on the source-checked product record
AgentValley requires macOS 15 or later and operates alongside Claude Code. It works on MacBook screens with or without a notch and can be positioned on external displays.
A badge counter appears next to the notch indicating how many agents need attention and how long they have waited, accompanied by configurable musical notes and voice notifications.
Yes. When the included Claude Code plugin is installed, users can select Allow once or Deny directly from the notch panel to answer command requests.
AgentValley checks GitHub hourly for updates and sends an optional daily count containing app and macOS versions. Keychain credentials are only accessed for Plan limits and sent solely to Anthropic.
The application supports jumping directly to the active session tab in Terminal and iTerm2, as well as Ghostty when multiple sessions are not sharing the same directory.
