OpenUsage (Windows)

A Windows system-tray app for tracking AI coding tool subscriptions (Cursor, Claude, Codex, etc.).

This repository is a dedicated Windows port of the original OpenUsage.

Features

• Native Windows tray behavior
• Fast desktop app stack: Tauri 2 + React
• Plugin-based providers (JavaScript)
• Credentials stay local

Installation

Download an installer (.exe / .msi) from this repository's Releases tab.

Development

Prerequisites

• Bun (or Node.js + Bun)
• Rust (stable)
• Build Tools for Visual Studio 2022 (C++ workload)

Run locally

bun install
bun tauri dev

Build

bun tauri build

Publishing a release

See RELEASING.md for the full, copy/paste release flow.

1. Configure repository secrets:

• TAURI_SIGNING_PRIVATE_KEY
• TAURI_SIGNING_PRIVATE_KEY_PASSWORD (if your key is password-protected)

2. Ensure the updater public key in src-tauri/tauri.conf.json matches your private key.

3. Bump versions consistently:

• package.json
• src-tauri/Cargo.toml
• src-tauri/tauri.conf.json

4. Create and push a semver tag:

git tag vX.Y.Z
git push origin vX.Y.Z

The GitHub workflow .github/workflows/publish.yml builds Windows artifacts, publishes a GitHub Release, and verifies updater assets (latest.json, .sig).

Note: The workflow automatically rewrites the updater endpoint to the current repository ($GITHUB_REPOSITORY) during release builds.

Open source process

Please read before contributing:

• CONTRIBUTING.md
• CODE_OF_CONDUCT.md
• SECURITY.md

Credits

• Robin Ebers, creator of the original OpenUsage
• Peter Steinberger (@steipete), creator of CodexBar

License

MIT (see LICENSE)