{"id":19378159,"url":"https://github.com/almarklein/timetagger_cli","last_synced_at":"2025-04-06T15:12:13.873Z","repository":{"id":47511411,"uuid":"336652542","full_name":"almarklein/timetagger_cli","owner":"almarklein","description":"Track your time from the command-line","archived":false,"fork":false,"pushed_at":"2025-01-06T08:45:09.000Z","size":51,"stargazers_count":48,"open_issues_count":5,"forks_count":10,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-03-30T14:11:18.489Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/almarklein.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-02-06T22:46:50.000Z","updated_at":"2025-03-23T15:27:09.000Z","dependencies_parsed_at":"2024-11-10T09:05:09.954Z","dependency_job_id":"1a6c0086-a431-4428-8b30-f0189af20260","html_url":"https://github.com/almarklein/timetagger_cli","commit_stats":{"total_commits":24,"total_committers":4,"mean_commits":6.0,"dds":0.25,"last_synced_commit":"fb6178fc29ed1d0b8e08bb8331fa9966e25a993c"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/almarklein%2Ftimetagger_cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/almarklein%2Ftimetagger_cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/almarklein%2Ftimetagger_cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/almarklein%2Ftimetagger_cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/almarklein","download_url":"https://codeload.github.com/almarklein/timetagger_cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247500468,"owners_count":20948880,"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":[],"created_at":"2024-11-10T09:05:01.996Z","updated_at":"2025-04-06T15:12:13.845Z","avatar_url":"https://github.com/almarklein.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![CI](https://github.com/almarklein/timetagger_cli/workflows/CI/badge.svg)](https://github.com/almarklein/timetagger_cli/actions)\n\n# timetagger_cli\n\nTrack your time from the command-line\n\n\n## Introduction\n\nThis is a command line interface (CLI) that connects to a\n[TimeTagger](https://github.com/almarklein/timetagger) server.\nThis can be the server at https://timetagger.app, or a self-hosted server.\n\nThe idea is to provide a quick way to track time for devs who are already using\na terminal.\n\n\n## Installation\n\nThe TimeTagger CLI requires Python 3.6 or higher. Install with `pip`:\n```\n$ pip install timetagger_cli\n```\n\nAfter installation, you should be able to use the `timetagger`command.\n\nStart by running `timetagger setup` to setup the API's url and authentication token.\n\n\n## Docs\n\nRun `timetagger` without arguments to get the list of available subcommands:\n\n```\n$ timetagger\nusage: timetagger [-h] [--version] {setup,app,status,show,start,stop,add,resume} ...\n\nTrack your time from the command-line, a CLI for https://timetagger.app.\n\npositional arguments:\n  {setup,app,status,show,start,stop,add,resume}\n    setup               Edit the API URL and token by opening the config file in your default editor.\n    app                 Open the TimeTagger app in your default browser.\n    status              Get an overview of today and this week. The exact content may change.\n    show                List records of the requested time frame.\n    start               Start timer with the given description. Use '#' to create tags.\n    stop                Stop any running timers.\n    add                 Add already finished task.\n    resume              Start a timer with the same description as the selected record.\n\noptions:\n  -h, --help            show this help message and exit\n  --version             show program's version number and exit\n```\n\n\n## Example\n\n```\n$ timetagger status\nHours clocked this week: 11:42\nHours clocked today: 7:00\nRunning: 0:01 - #timeapp #oss more cli\n\nTodays records:\n          Started           Stopped  Duration  Description\n 2021-03-23 09:05             09:42      0:37  #oss #vispy prep\n 2021-03-23 09:42             12:12      2:30  #timeapp #oss cli\n 2021-03-23 13:06             14:00      0:53  #timeapp #oss cli\n 2021-03-23 14:00             14:58      0:58  #oss #vispy #meeting\n 2021-03-23 15:24             17:13      1:49  #timeapp #oss cli\n 2021-03-23 17:13                 -      0:12  #timeapp #oss more cli\n```\n\n\n## License\n\nMIT\n\n\n## Developers\n\nAdditional developer dependencies:\n```\npip install invoke black flake8 pytest\n```\n\n* `invoke -l` to see available invoke tasks\n* `invoke clean` to remove temporary files\n* `invoke format` to autoformat the code (using black)\n* `invoke lint` to detect linting errors (using flake8)\n* `invoke tests` to run tests (using pytest)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falmarklein%2Ftimetagger_cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falmarklein%2Ftimetagger_cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falmarklein%2Ftimetagger_cli/lists"}