Metadata-Version: 2.4
Name: manualwakatime
Version: 0.1.0
Summary: Manual WakaTime tracker — send heartbeats with a live TUI
Author: benne
License-Expression: MIT
Project-URL: Homepage, https://github.com/anomalyco/mwt
Project-URL: Issues, https://github.com/anomalyco/mwt/issues
Keywords: wakatime,time-tracking,cli,tui
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich>=13.0.0
Requires-Dist: requests>=2.28.0
Dynamic: license-file

# mwt — Manual WakaTime Tracker

A CLI tool for manually sending [WakaTime](https://wakatime.com) heartbeats.  
Fire up a live TUI, track a project, and let it heartbeat every minute.

Supports the official WakaTime API as well as compatible servers like [Hackatime](https://hackatime.hackclub.com).

## Install

```bash
pip install mwt
```

## Quick start

```bash
mwt start my-project
```

A fullscreen TUI opens showing:

- Elapsed time
- Heartbeats sent
- Last heartbeat timing
- Live status

Press **q** or **Ctrl+C** to stop.

## Commands

| Command | Description |
|---------|-------------|
| `mwt start <project>` | Start tracking a project |
| `mwt start` | Interactive picker — choose from recent projects |
| `mwt projects` | List recently tracked projects |
| `mwt config` | Show API key/URL status |
| `mwt` | Show help |

## Configuration

The API key and URL are read from (in order of priority):

1. Environment variables: `WAKATIME_API_KEY`, `WAKATIME_API_URL`
2. The standard WakaTime config file: `~/.wakatime.cfg`

Project history is stored at `%APPDATA%/mwt/projects.json` (Windows) or `~/.config/mwt/projects.json` (Linux/macOS).

## License

MIT
