feat: add native macOS menu bar app (ClaudeMonitor)

README.md

@@ -37,6 +37,7 @@ A beautiful real-time terminal monitoring tool for Claude AI token usage with ad
   - [Installation Issues](#installation-issues)
   - [Runtime Issues](#runtime-issues)
 - [📞 Contact](#-contact)
+- [🍎 macOS Status Bar App](#-macos-status-bar-app)
 - [📚 Additional Documentation](#-additional-documentation)
 - [📝 License](#-license)
 - [🤝 Contributors](#-contributors)
@@ -1151,6 +1152,20 @@ Have questions, suggestions, or want to collaborate? Feel free to reach out!
 Whether you need help with setup, have feature requests, found a bug, or want to discuss potential improvements, don't hesitate to get in touch. I'm always happy to help and hear from users of the Claude Code Usage Monitor!
 
 
+## 🍎 macOS Status Bar App
+
+A native macOS menu bar companion app is available in [`macos-stats-bar/`](macos-stats-bar/README.md). Built entirely in Swift with zero external dependencies, it sits in your menu bar and shows token rates and cost at a glance.
+
+**Highlights:**
+- Live double-row token rates in the menu bar; switches to accumulated cost when idle
+- Detail panel with total cost, top 5 projects, and recent records
+- Auto-refreshes every 5 seconds — no daemon, no network requests, reads local JSONL files directly
+- Universal binary (Intel + Apple Silicon), requires macOS 14.0+
+
+See the [macOS App README](macos-stats-bar/README.md) for installation and build instructions.
+
+---
+
 ## 📚 Additional Documentation
 
 - **[Development Roadmap](DEVELOPMENT.md)** - ML features, PyPI package, Docker plans

macos-stats-bar/.gitignore

@@ -0,0 +1,17 @@
+# Xcode build artifacts
+DerivedData/
+build/
+*.xcarchive
+
+# Xcode user-specific files
+*.xcuserdata/
+xcuserdata/
+*.xcworkspace/xcuserdata/
+*.pbxuser
+*.mode1v3
+*.mode2v3
+*.perspectivev3
+
+# macOS metadata
+.DS_Store
+.DS_Store?