Skip to content

maddada/agent-manager-x

Repository files navigation

Agent Manager X

2026-04-14_Google Chrome_08-24-51@2x

A macOS desktop app to monitor your Claude Code, Codex, OpenCode AI coding agents in real-time with voice or bell notifications.
Easily jump to a conversation in any editor or terminal!

Shows RAM and CPU usage for every running session and lets you close stale or idle chats that are wasting memory with one click.

This project is built as a native macOS app with Swift and SwiftUI to make it very snappy and light.

Project inspired by @ozankasikci, whose app is built with Tauri + React and now has a different feature set.

Please star his repo here: https://github.com/ozankasikci/agent-sessions.

Installation

brew install --cask maddada/tap/agent-manager-x

Or download the latest DMG from GitHub Releases.

See changelog.md for release notes and version history.


Latest in 2.5

  • Refined the expanded mini viewer row layout so the agent icon and status indicator can swap positions on the right-side sidebar, keeping the expanded view easier to scan.
  • Tightened whole-card hover handling so expanded hoverable areas track the actual row cards instead of the entire panel bounds.
  • Synced the bundled mini viewer resources with the latest project icon and expanded-row presentation updates.

(New!) Mini floating sidebar mode

Sticks to the left/right side of your screen. Hover to see all details. Click to jump to terminal. Always visible. Toggleable with hotkey!

2026-02-13_CleanShot_10-56-07@2x 2026-02-13_CleanShot_10-56-02@2x 2026-02-13_CleanShot_10-55-56@2x

Full app mode:

Can be shown/hidden with a hotkey. Tons of features (Read below)

2026-02-13_Vivaldi Snapshot_10-57-31@2x

Short 3 min Demo of AMX: Link for mobile

Short.Demo.of.AMX.part.of.my.Best.Agentic.Workflow.video.mp4

Full video showing the best agentic workflow I found for easily managing 10+ agents https://youtube.com/watch?v=5LRAKaYJXjw

Features

  • View all active coding agent sessions in one place
  • Real-time status detection (Thinking, Processing, Waiting, Idle)
  • Global hotkey to toggle visibility (default: Ctrl+Space, configurable, I personally use ctrl+shift+cmd+s)
  • Mini floating display mode with per-monitor pinning, session caps, smarter recent-session filtering, configurable expand and collapse delays, smarter whole-card hover zones, smoother staged animations, project icons, and quick project switching
  • Configurable run, build, commit, and push buttons for each project
  • Reliably shows current progress and status of all sessions
  • Shows CPU and RAM consumption for all sessions and lets you close stale sessions with one click to save resources
  • Improved UX in a bunch of areas like grouping sessions per project
  • Added audio notifications for Codex and Claude Code (Summary Text to Speech and Bell modes)
  • Claude Code, OpenCode, and Codex CLI support
  • A lot of editors and terminals supported
  • Added ability to click on a session to instantly jump to it
  • Remember last location and size
  • Default Editor and Default Terminal Support
  • Themes and background image support
  • Close buttons for a project's sessions, for all from a specific agent, for all stale sessions, etc.
  • Added fading and sorting based on the last activity on each session (5 mins = idle, 10 minutes = stale)
  • Supports both process-based session discovery and VSmux-backed session views, including protected active overflow sessions, per-session project identity, workspace favicon propagation, and filtering for blank root Claude placeholders

Please ask or do a PR if you have any feature ideas!

Supported Agents

  • Claude Code - Anthropic's official CLI for Claude
  • OpenCode - Open-source AI coding assistant
  • Codex - OpenAI's coding agent CLI

About

A macOS desktop app to monitor your Claude Code, Codex, OpenCode AI coding agents in real-time with voice or bell notifications. Easily jump to a conversation in any editor or terminal! Shows RAM and CPU usage for every running session and lets you code Stale or Idle chats that are wasting memory with 1 click!

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors