winget install --id=MiguelAngelRamirez.MyAgents -e A lightweight Windows tray app that shows every running Claude Code and Codex session (in WSL and native Windows) with live status, lets you click a session to focus its terminal, and shows official 5h/7d usage bars captured from each CLI's own data — no tokens read, no undocumented endpoints called.
MacOS
Windows
A lightweight, always-visible app that watches all your AI-coding terminals at once. See what every Claude Code and Codex session is doing (thinking / running a tool / awaiting permission / idle), jump to the exact terminal with one click, and keep an eye on your 5h / 7d usage — without reading any token or calling any undocumented endpoint.
winget install MiguelAngelRamirez.MyAgents.brew install --cask miguelangelxramirez/tap/myagents.Same product, same privacy contract on both. Jump to Install.
https://github.com/user-attachments/assets/350c4716-db66-4904-97b3-0ead7a5e613e
https://github.com/user-attachments/assets/a53e9fb5-1627-4566-8213-96e9daf57d7e
Both platforms give you the same core:
~/.claude and Codex config.
Anyone who already has Claude Code and/or Codex installed and signed in, runs several sessions at once, and wants a single always-visible place to see what each is doing and jump to it. Usage requires a Pro/Max Claude plan and/or a Codex plan (the same accounts the CLIs use).
Windows
\\wsl.localhost)macOS
PATH (the status hooks are tiny Node scripts, and the app launches Codex's app-server through a login shell to inherit the same PATH your terminal has)winget install MiguelAngelRamirez.MyAgents
After installing with winget, run it once: press ⊞ Win + R, type myagents, and press Enter (or run
myagents in any terminal). From then on it lives in your tray, adds itself to the Start menu (press
⊞ Win and type "MyAgents" to reopen it), and — if you enable Start with Windows — launches on boot.
Or download the latest MyAgents.exe from the Releases page and run it directly (it's a self-contained single file — no install needed).
brew install --cask miguelangelxramirez/tap/myagents
Then launch it once (open -a MyAgents, or from Spotlight) — it lives in the menu bar, with no Dock icon.
Open its ⚙ menu and choose Enable tracking the first time, so it can see your sessions.
Or download MyAgentsMac-.zip from the Releases page,
unzip, and drag MyAgentsMac.app to /Applications. Either way the app is signed with a Developer ID and
notarized by Apple, so it opens with a double-click — no Gatekeeper warnings.
Requires macOS 26 or newer.
Launch it (double-click the exe / the MyAgents shortcut, or the winget-installed command). It appears
as a robot icon in the tray and a widget in the bottom-right corner.
> Reopening it after you close it: on first launch it adds itself to the Start menu, so just press > Start and type "MyAgents" to open it again anytime. (Enabling Start with Windows, below, means > you rarely need to.)
> ▶ Watch a short demo — opening and closing the app.
> Tip: enable Start with Windows from the ⚙ menu so it's always running and you never have to hunt for it.
Launch it (Spotlight / Launchpad → "MyAgents", or open -a MyAgents). It's a menu-bar-only app — no Dock
icon, no window; everything lives behind the glyph in the menu bar.
Permissions it asks for (both only the first time it actually needs them, never upfront):
It's not sandboxed (by design — reading ~/.claude, listing processes, and focusing other apps don't fit
the App Store sandbox), but it never asks for Full Disk Access, Accessibility, or Screen Recording.
Each row shows three lines: name · folder · state. Claude's name is the task summary it generates
(ai-title); Codex's name is the session's first prompt. A finished-but-unopened session shows a small dot,
cleared when you click it. The left accent bar is the provider colour (Claude orange / Codex teal); the
moving glyph (a little robot) shows it's busy.
A session is considered open while its claude/codex process is alive — so the list survives reboots,
sleep/resume and idle, and a closed session disappears on its own.
Usage is opt-in (off by default; enable Show usage in the ⚙ menu). When on:
rate_limits — captured by a tiny statusline
script we register (which also transparently runs any statusline you already had).app-server RPC (account/rateLimits/read) — the same
mechanism CodexBar uses.Both are live, token-free, and official — no OAuth token is read and no undocumented endpoint is called in the public build. If Codex is at its limit (or WSL is momentarily unavailable on Windows), Codex usage falls back to the value it last wrote to its rollout file. A stale Claude reading (idle session) is greyed and labelled "N m ago" rather than shown as if it were live.
A small robot / glyph, tinted by state, or your 5h usage % as a badge when usage is on. On Windows, left-click the tray robot toggles the widget; if you don't see it, click the tray overflow arrow (▲) and drag it out to keep it visible. On macOS it sits in the menu bar and opens the popover.
Windows
winget upgrade MiguelAngelRamirez.MyAgents (or winget upgrade --all).MyAgents.exe from Releases and replace the old one.Updates ship as GitHub Releases; winget tracks them, so there's no self-replacing auto-updater (which antivirus tends to flag).
macOS
brew update && brew upgrade --cask myagents..zip: the app updates itself with Sparkle (⚙ menu → Check for Updates…, plus an
automatic background check you can opt into on first launch).See PUBLISHING.md for the full release, winget, and Homebrew flow.
.txt (sessions, live processes, settings, recent
perf/focus log — no tokens) you can attach to an issue. Or set CCAPP_DEBUG=1 before launching to log to
%TEMP%\myagents.log. Settings live at %APPDATA%\MyAgents\settings.json.~/Library/Preferences/com.miguelangelramirez.myagents.mac.plist.This project is open source — you can audit exactly what it does. The public build reads no tokens and calls no network usage endpoints on either platform. Concretely:
~/.claude/statusbar/sessions.d/, from
Codex rollout files, and from which claude/codex processes are alive (via UI Automation on Windows;
libproc/sysctl — public APIs only — on macOS).app-server RPC using your already-cached login (no token sent
over the network, no undocumented HTTP endpoint).%APPDATA%\MyAgents\settings.json on Windows,
UserDefaults on macOS..zip installs instead.)> A separate local-only build flag (USAGE_LOCAL) keeps the old undocumented OAuth/wham endpoints as a
> fallback — that code is compiled out of the public release. See PUBLISHING.md.
To remove everything cleanly, see docs/uninstall.md (⚙ menu → Uninstall / Remove tracking does it, including restoring any statusline you had).
~/.claude/settings.json and Codex managed hooks,
plus a statusline capture script. On Windows that spans native Windows + each running WSL distro (Codex hooks
under /etc/codex); on macOS it's the local filesystem directly.app-server RPC (Codex).Windows (.NET 8 SDK)
# Public (ship this): usage is token-free only
dotnet publish src/MyAgents -c Release -r win-x64 --self-contained true `
-p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true
# → bin\Release\net8.0-windows\win-x64\publish\MyAgents.exe
macOS (Xcode 26 + XcodeGen)
cd mac
xcodegen generate # the .xcodeproj is generated, never hand-edited
xcodebuild -project MyAgentsMac.xcodeproj -scheme MyAgentsMac -configuration Release build \
-destination 'platform=macOS'
See PUBLISHING.md for the framework-dependent build, the USAGE_LOCAL flavor, the
winget flow, and the macOS Developer ID + notarization + Homebrew release checklist. The macOS-specific
guide lives in mac/README.md.
MIT — see LICENSE. Inspired by, and with attributions in THIRD-PARTY-NOTICES.md:
m1ckc3s/claude-status-bar (the hook mechanism),
CodeZeno/Claude-Code-Usage-Monitor (usage display),
onikan27/claude-code-monitor, and
steipete/CodexBar (the Codex app-server RPC approach).