{"id":28563583,"url":"https://github.com/gochrono/chrono","last_synced_at":"2025-06-10T13:02:42.340Z","repository":{"id":53533714,"uuid":"152128920","full_name":"gochrono/chrono","owner":"gochrono","description":"A fast time tracking tool made with love","archived":false,"fork":false,"pushed_at":"2021-03-25T22:30:55.000Z","size":501,"stargazers_count":32,"open_issues_count":10,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-06-19T02:09:26.081Z","etag":null,"topics":["chrono","cli","go","golang","linux","linux-cli","time-tracker"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gochrono.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-10-08T18:42:42.000Z","updated_at":"2024-04-02T17:40:30.000Z","dependencies_parsed_at":"2022-08-20T12:31:49.272Z","dependency_job_id":null,"html_url":"https://github.com/gochrono/chrono","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gochrono%2Fchrono","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gochrono%2Fchrono/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gochrono%2Fchrono/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gochrono%2Fchrono/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gochrono","download_url":"https://codeload.github.com/gochrono/chrono/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gochrono%2Fchrono/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259080921,"owners_count":22802393,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chrono","cli","go","golang","linux","linux-cli","time-tracker"],"created_at":"2025-06-10T13:02:26.388Z","updated_at":"2025-06-10T13:02:42.329Z","avatar_url":"https://github.com/gochrono.png","language":"Go","readme":"![Alt chrono](./.github/full-logo-with-tagline.png)\n\n[![GitHub Release](https://img.shields.io/github/release-pre/gochrono/chrono.svg)](https://github.com/gochrono/chrono/releases)\n[![Go Report Card](https://goreportcard.com/badge/github.com/gochrono/chrono)](https://goreportcard.com/report/github.com/gochrono/chrono)\n[![Build Status](https://travis-ci.org/gochrono/chrono.svg?branch=master)](https://travis-ci.org/gochrono/chrono)\n![GitHub](https://img.shields.io/github/license/gochrono/chrono.svg)\n![Golang Version](https://img.shields.io/badge/Go-1.11-lightgrey.svg)\n\n\n\n## Overview ##\n\nChrono is a time tracking tool written in Go.\nIt is fast and simple to use.\n\nWant to know what you did with your time? Chrono will help you with that. Track how\nlong you spend on a project. Add notes so you know exactly what\nyou did.\n\n[![asciicast](https://asciinema.org/a/pb5PlJHshi2gjpDeQYCj0gmfI.svg)](https://asciinema.org/a/pb5PlJHshi2gjpDeQYCj0gmfI)\n\n\n## Installation ##\n\n### Binaries Releases ###\n\nTo install the latest stable release:\n\n``` bash\ncurl -L https://git.io/fpHAj | sh\n```\n\nWe provide pre-built Chrono binaries for Windows, Linux, and macOS (Darwin) for x64 and i386 architectures.\n\nIf you'd like to install a specific version, checkout the [releases page](https://github.com/gochrono/chrono/releases).\n\nIf you want to run the absolute latest version, [build it from source](#building-chrono-from-the-source).\n\n### Package Managers ###\n\nIf you are using __Arch Linux__, you can install the AUR package [chrono-git][2] to get the latest version or [chrono][3] for the latest stable release.\n\nIf you're using __Ubuntu__ or a __Debian__ based system, you can find debian packages (.deb) on the [releases page](https://github.com/gochrono/chrono/releases).\n\n## Quickstart ##\n\n### Usage ###\n\nTo start tracking time a project, use the `start` command:\n\n``` bash\n$ chrono start development +chrono\n```\n\nIf you wanted to set the start time to something other than now, use the '--start' flag:\n\n``` bash\n$ chrono start development --at \"2019-02-01 13:00\"\n```\n\nTime is parsed by [jinzhu/now][now] so it should be in a format it can understand.\n\nThis creates a new __frame__ for the development project with the chrono tag.\n\nKeep notes of what you do for a project with the `notes add` command:\n\n``` bash\n$ chrono notes add \"made some awesome changes to the README\"\n$ chrono notes show\n[0]: made some awesome changes to the README\n```\n\nThe notes are added to the current __frame__.\n\nGet information about the current frame with the `status` command:\n\n``` bash\n$ chrono status\nProject development [chrono] started 10 seconds ago.\n```\nTo stop tracking time for the current frame, use the `stop` command:\n\n``` bash\n$ chrono stop\nStopping project development [chrono], started 5 minutes ago (id: 073bbf).\n```\n\nYou can show a chronolical list of the current day's session (or __frames__) through the `log` command:\n\n``` bash\n$ chrono log\nMonday  3 December 2018\n    (ID: 0d3131) 10:15 to 10:20     0h 05m 00s  development [chrono]\n```\n\nFor a list of all available commands, use the `help` command:\n\n```\n$ chrono help\n```\n\nFor a list of all available options and arguments for a command, use the `---help` flag:\n\n```\n$ chrono log --help\n```\n\n## Building Chrono from the Source ##\n\n### Prequisite Tools ###\n\n* [Git](https://git-scm.com/)\n* [Go (at least Go 1.11)](https://golang.org/dl/)\n\n\n### Downloading \u0026 building the source ###\n\nChrono uses [Go Modules](https://github.com/golang/go/wiki/Modules) to handle dependencies.\n\nThe easiest way to build from the source is to clone Chrono in a directory outsite of `GOPATH`, for example:\n\n``` bash\nmkdir ~/src \u0026\u0026 cd ~/src\ngit clone https://github.com/gochrono/chrono.git\ncd chrono\ngo install\n```\n\nMake sure `$GOPATH/bin` is on `$PATH`.\n\nIf you haven't customized your `$GOPATH` then you'll need to add `~/go/bin` to `$PATH`.\n\n## Contributing to Chrono ###\n\nTo contribute to the Chrono project or documentation, you should [fork the GitHub project](https://github.com/gochrono/chrono#fork-destination-box) and clone it to your machine.\n\nFor a complete guide to contributing to Chrono, see the [Contribution Guide](CONTRIBUTING.md).\n\nWe welcome contributions of many kinds from updating documentation, feature requests, bug reports \u0026 issues,\nfeature implementation, pull requests, answering other users questions, etc.\n\n### Asking Support Questions ###\n\nWe currently don't have a discussion forum. For now, use the issue tracker to ask questions.\n\n### Reporting Issues ###\n\nIf you believe you have found an issue or bad documentation, use\nthe GitHub issue tracker to report the problem to the Chrono maintainers.\n\nWhen reporting an issue, please provide the version of chrono is use (`chrono version`)\n\n[now]: https://github.com/jinzhu/now#parse-string-to-time\n[1]: https://asciinema.org/a/pb5PlJHshi2gjpDeQYCj0gmfI\n[2]: https://aur.archlinux.org/packages/chrono-git/\n[3]: https://aur.archlinux.org/packages/chrono/\n","funding_links":[],"categories":["Time Tracking CLI Tools"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgochrono%2Fchrono","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgochrono%2Fchrono","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgochrono%2Fchrono/lists"}