feat: add macOS menu bar wrapper (contrib)

[anlvdt]

Summary

A lightweight Python menu bar app that wraps the codex-account-switcher CLI, providing a native macOS menu bar experience for quick account switching — no TUI needed.

Features

• ⚡ Persistent menu bar icon showing current account name
• One-click switching — click any saved account to switch instantly
• Auto Codex restart — kills and relaunches Codex after switching
• Non-destructive Add Account — login with a new account without losing the current one
• Usage/quota display — see remaining weekly % per account
• Auto-start on login — via macOS LaunchAgent

How it works

The wrapper calls codex-account-switcher CLI commands (status --json, list --json, save, activate, delete) under the hood, so all auth management is handled by the existing Rust implementation.

Files

contrib/macos-menubar/
├── README.md              # Documentation
├── codex_switcher.py      # Main menu bar app (rumps)
├── requirements.txt       # Python deps (rumps)
└── setup.sh               # Install script (venv + LaunchAgent)

Install

cd contrib/macos-menubar
chmod +x setup.sh
./setup.sh

Requirements

• macOS 13+, Python 3.9+
• codex-account-switcher CLI on PATH

Menu

Item	Action
✅ email@example.com	Current active account
○ other@example.com	Click to switch
💾 Save Current Account	Snapshot current auth
🔑 Add New Account…	Non-destructive add flow
🗑 Delete Account	Remove saved snapshot
🔄 Refresh	Reload menu

Motivation

Many macOS users prefer a persistent menu bar icon over a TUI for quick account switching. This wrapper provides that experience while leveraging the existing CLI for all auth operations.

[Pimpmuckl]

Since this is python and would introduce a dependency I would say it makes most sense to keep it in your own fork for now.

This way the releases can simply be installed stand-alone, the python wrapper would complicate that.

And since this is 100% Rust for now, I'd like to keep it that way. In case you want to re-do that in rust, you're more than welcome to open another PR!

The feature is, of course, great though!