https://github.com/mlange-42/track
Track is a time tracking command line tool
https://github.com/mlange-42/track
cli-app time-tracking
Last synced: 7 months ago
JSON representation
Track is a time tracking command line tool
- Host: GitHub
- URL: https://github.com/mlange-42/track
- Owner: mlange-42
- License: mit
- Created: 2022-12-23T16:15:04.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-10-09T09:45:57.000Z (about 2 years ago)
- Last Synced: 2025-02-28T08:55:50.612Z (8 months ago)
- Topics: cli-app, time-tracking
- Language: Go
- Homepage: https://mlange-42.github.io/track/
- Size: 1.72 MB
- Stars: 5
- Watchers: 1
- Forks: 3
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Track
[](https://github.com/mlange-42/track/actions/workflows/tests.yml)
[](https://github.com/mlange-42/track)
[](https://mlange-42.github.io/track/)
[](https://github.com/mlange-42/track/blob/main/LICENSE)
Track is a time tracking command line tool.
*Track* is designed to be easy to use, and stores tracking entries in a human-readable plain-text format.
## Features
* Track your working time from the command line
* Natural language-like syntax
* Supports hierarchical project structure
* Records stored as plain-text files for human readability and editing
* Different types of text-based and graphical reports
## Getting started
See the **[:blue_book: Track Documentation](https://mlange-42.github.io/track/)** for a comprehensive user guide!
### Installation
**Using Go:**
```shell
go install github.com/mlange-42/track@latest
```
**Without Go:**
Download binaries for your OS from the [Releases](https://github.com/mlange-42/track/releases/).
### Usage
Any time tracking `track` is associated to a *Project*.
Before you can start tracking, create a project:
```shell
track create project MyProject
```
Now, start tracking time on the project:
```shell
track start MyProject
```
To stop tracking, use:
```shell
track stop
```
Get information about the current tracking status:
```shell
track status
```
See the [:blue_book: Track Documentation](https://mlange-42.github.io/track/) for details and more commands.
## References
* Heavily inspired by [`timetrace`](https://github.com/dominikbraun/timetrace) and [`klog`](https://github.com/jotaen/klog)