{"id":31299222,"url":"https://github.com/stevengonsalvez/qstatus","last_synced_at":"2026-05-07T15:42:06.447Z","repository":{"id":314583834,"uuid":"1056057559","full_name":"stevengonsalvez/qstatus","owner":"stevengonsalvez","description":"Real-time monitoring for Amazon Q Developer (formerly Q/Claude) usage with native macOS menubar app and CLI dashboard","archived":false,"fork":false,"pushed_at":"2026-04-09T08:58:17.000Z","size":27533,"stargazers_count":0,"open_issues_count":11,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-04-09T10:28:20.671Z","etag":null,"topics":["amazon-q","amazon-q-cli","amazon-q-developer","amazon-q-status","cli","cost-tracking","developer-tools","macos","macos-app","menubar","monitoring","productivity","rust","swift","usage-tracking"],"latest_commit_sha":null,"homepage":"https://github.com/stevengonsalvez/qstatus/releases","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stevengonsalvez.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-13T09:54:25.000Z","updated_at":"2026-04-02T09:44:06.000Z","dependencies_parsed_at":"2025-09-13T13:03:16.064Z","dependency_job_id":null,"html_url":"https://github.com/stevengonsalvez/qstatus","commit_stats":null,"previous_names":["stevengonsalvez/qstatus"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/stevengonsalvez/qstatus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevengonsalvez%2Fqstatus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevengonsalvez%2Fqstatus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevengonsalvez%2Fqstatus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevengonsalvez%2Fqstatus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stevengonsalvez","download_url":"https://codeload.github.com/stevengonsalvez/qstatus/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevengonsalvez%2Fqstatus/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32744559,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-07T02:14:30.463Z","status":"ssl_error","status_checked_at":"2026-05-07T02:14:29.405Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amazon-q","amazon-q-cli","amazon-q-developer","amazon-q-status","cli","cost-tracking","developer-tools","macos","macos-app","menubar","monitoring","productivity","rust","swift","usage-tracking"],"created_at":"2025-09-25T00:08:35.191Z","updated_at":"2026-05-07T15:42:06.406Z","avatar_url":"https://github.com/stevengonsalvez.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# QStatus Monitor 🚀\n\nReal-time monitoring for your Amazon Q Developer usage with native macOS menubar app and CLI dashboard.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/screenshots/menu.png\" width=\"400\" alt=\"QStatus Menubar\"\u003e\n  \u003cimg src=\"docs/screenshots/tui.png\" width=\"400\" alt=\"QStatus CLI\"\u003e\n\u003c/p\u003e\n\n## ✨ Features\n\n### 📊 Real-time Monitoring\n- **Token Usage**: Track context window consumption across all sessions\n- **Cost Tracking**: Monitor spending by day, week, and month\n- **Burn Rate**: See your token consumption rate in real-time\n- **Message Quota**: Track your monthly message allowance (363/5000 shown above)\n\n### 🎯 Dual Interface\n- **macOS Menubar App**: Always-visible usage indicator with detailed dropdown\n- **CLI Dashboard**: Full-featured terminal UI for power users\n\n### 🔥 Smart Analytics\n- **Session Tracking**: Individual conversation monitoring with folder organization\n- **Visual Indicators**: Color-coded usage bars (green/yellow/red)\n- **Top Sessions**: Sort by tokens, usage percentage, or cost\n- **Group by Folder**: Organize sessions by project directory\n\n## 📦 Installation\n\n### Homebrew (Easiest)\n\n```bash\n# Add the tap\nbrew tap stevengonsalvez/qstatus\n\n# Install CLI tool\nbrew install qstatus-cli\n\n# Install Menubar app\nbrew install --cask qstatus-menu\n```\n\n### Quick Install Script\n\n```bash\n# Download and run the installer\ncurl -sSL https://github.com/stevengonsalvez/qstatus/releases/latest/download/install.sh | bash\n```\n\n### Install from Release\n\n1. Download the latest release from [Releases](https://github.com/stevengonsalvez/qstatus/releases)\n2. Open `QStatus.dmg`\n3. Drag **QStatus** to your Applications folder\n4. Launch from Applications or Spotlight\n\n### Build from Source\n\n```bash\n# Clone the repository\ngit clone https://github.com/stevengonsalvez/qstatus.git\ncd qstatus\n\n# Install both apps (from qstatus-menu directory)\ncd qstatus-menu \u0026\u0026 make install\n\n# Or install individually\nmake install-cli      # CLI only\nmake install-menubar  # Menubar app only\n```\n\n## 🖥️ Usage\n\n### Menubar App\n\n\u003cimg src=\"docs/screenshots/menu.png\" width=\"350\" align=\"right\"\u003e\n\n1. Launch **QStatus** from Applications\n2. Click the menubar icon to see:\n   - **Overall stats**: Sessions, tokens, costs\n   - **Recent sessions**: Visual progress bars\n   - **Top sessions**: Sortable by different metrics\n   - **Preferences**: Customize settings\n\n**Features:**\n- 🟢 Green = Safe usage (\u003c50%)\n- 🟡 Yellow = Warning (50-90%)\n- 🔴 Red = Critical (\u003e90%)\n- Click any session for detailed breakdown\n- Search sessions by ID or folder\n- Group toggle for folder-based view\n\n### CLI Dashboard\n\n\u003cimg src=\"docs/screenshots/tui.png\" width=\"350\" align=\"right\"\u003e\n\n```bash\n# Run the dashboard (interactive TUI by default)\nqstatus\n\n# With custom refresh rate\nqstatus --refresh-rate 5\n\n# Enable debug logging\nqstatus --debug\n```\n\n**Features:**\n- Real-time updates every 2 seconds\n- Session list with usage indicators\n- System metrics and burn rate\n- Message quota tracking\n- Color-coded warnings\n\n## ⚙️ Configuration\n\n### Menubar Preferences\n- **Context Window**: Default 175,000 tokens (configurable)\n- **Token Pricing**: Default $0.0066/1K tokens (configurable)  \n- **Refresh Rate**: Update interval in seconds\n- **Compact Mode**: Toggle detailed view elements\n\n### Database Location\nBoth apps read from Amazon Q's SQLite database:\n```\n~/Library/Application Support/amazon-q/data.sqlite3\n```\n\n## 🛠️ Development\n\n### Requirements\n- macOS 11.0+\n- Rust (for CLI)\n- Swift 5.5+ (for menubar app)\n- Xcode Command Line Tools\n\n### Project Structure\n```\nqstatus/\n├── qstatus-cli/        # Rust CLI application\n│   ├── src/\n│   └── Cargo.toml\n├── qstatus-menu/    # Swift menubar application\n│   ├── Sources/\n│   ├── Package.swift\n│   └── Makefile\n├── docs/\n│   └── screenshots/     # Application screenshots\n└── README.md\n```\n\n### Building\n\n```bash\n# From qstatus-menu directory\ncd qstatus-menu\n\n# Build everything\nmake all\n\n# Create release packages\nmake release\n\n# Clean build artifacts\nmake clean\n```\n\n## 📝 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## 🐛 Known Issues\n\n- Menubar app requires accessibility permissions on first launch\n- CLI requires `/usr/local/bin` in PATH\n- Database path may vary based on Amazon Q installation method\n\n## 📊 Screenshots\n\n### Menubar Dropdown View\n\u003cimg src=\"docs/screenshots/menu.png\" width=\"600\" alt=\"Menubar App\"\u003e\n\n*Real-time monitoring with visual indicators, sortable sessions, and quota tracking*\n\n### CLI Dashboard\n\u003cimg src=\"docs/screenshots/tui.png\" width=\"600\" alt=\"CLI Dashboard\"\u003e\n\n*Terminal UI with session list, metrics, and burn rate tracking*\n\n## 🙏 Acknowledgments\n\n- Built for the Amazon Q Developer community\n- Inspired by the need for better usage visibility\n- Thanks to all contributors and testers\n\n## 📮 Support\n\nFor issues, questions, or suggestions:\n- [Open an issue](https://github.com/stevengonsalvez/qstatus/issues)\n- [Discussions](https://github.com/stevengonsalvez/qstatus/discussions)\n\n---\n\n\u003cp align=\"center\"\u003e\n  Made with ❤️ for developers using Amazon Q Developer\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/stevengonsalvez/qstatus/releases\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/v/release/stevengonsalvez/qstatus?style=flat-square\" alt=\"Latest Release\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/stevengonsalvez/qstatus/blob/main/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square\" alt=\"License\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/stevengonsalvez/qstatus/stargazers\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/stars/stevengonsalvez/qstatus?style=flat-square\" alt=\"Stars\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstevengonsalvez%2Fqstatus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstevengonsalvez%2Fqstatus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstevengonsalvez%2Fqstatus/lists"}