QDock GitHub

macOS 14+ • Open Source • Checksum Published

Claude & Codex Usage Tracker for macOS

QDock sits in your menu bar and shows live subscription usage for Claude and Codex. No opening settings pages. No terminal commands just to check usage.

Install Now How It Works

Install in 30 seconds

Choose your path. `npx` is the fastest.

Quick Install (Recommended)

Primary

Installs the latest stable release to your Mac.

npx @qdock/installer
  • No manual unpacking
  • Installs to `/Applications` by default
  • Launches app after install

Download DMG

Manual

Prefer drag-and-drop install? Grab the latest DMG.

Download Latest DMG

Latest release: checking...

Build from Source

Developers

For contributors and local debugging.

git clone https://github.com/altansaid/QDock.git qdock cd qdock swift build && swift run QDock

How QDock works

QDock detects supported providers on your machine, fetches usage windows, and reflects usage level directly in the menu bar icon and percentage text.

Provider Detection

Finds Claude and Codex from local environment and auth state.

Live Refresh

Refresh rate adapts based on risk level to keep high-usage sessions accurate.

Secure Storage

Manual tokens are stored in macOS Keychain. Each release includes checksums.

FAQ

Does this support Windows or Linux?

No. QDock currently targets macOS 14+ only.

What if `npx` install fails?

Use the DMG download button above, or check GitHub Releases directly for the latest artifact.

macOS blocked QDock on first launch. What should I do?

This can happen after manual DMG install. Run xattr -cr /Applications/QDock.app in Terminal, then right-click QDock.app and choose Open once. If installed under ~/Applications, update the path in the command.

Is QDock open source?

Yes. Source code, issues, and contribution flow are available on GitHub.