{"id":23968968,"url":"https://github.com/joequery/toggl-cli","last_synced_at":"2025-04-13T16:22:59.931Z","repository":{"id":65952882,"uuid":"2642234","full_name":"joequery/Toggl-CLI","owner":"joequery","description":"Command Line Interface for working with Toggl","archived":false,"fork":false,"pushed_at":"2012-06-10T23:38:40.000Z","size":141,"stargazers_count":23,"open_issues_count":4,"forks_count":7,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-27T07:21:16.716Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joequery.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2011-10-25T08:58:11.000Z","updated_at":"2022-09-20T11:22:23.000Z","dependencies_parsed_at":"2023-02-18T05:35:13.362Z","dependency_job_id":null,"html_url":"https://github.com/joequery/Toggl-CLI","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joequery%2FToggl-CLI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joequery%2FToggl-CLI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joequery%2FToggl-CLI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joequery%2FToggl-CLI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joequery","download_url":"https://codeload.github.com/joequery/Toggl-CLI/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248741984,"owners_count":21154420,"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":"2025-01-07T00:56:56.983Z","updated_at":"2025-04-13T16:22:59.912Z","avatar_url":"https://github.com/joequery.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Toggl CLI\n\nAlthough time tracking is an essential workflow tool, taking the time to click through a web app every time you start and stop a task is extremely annoying. The Toggl CLI (Command Line Interface) attempts to solve this issue by making it easy and fast to track your time.\n\n## What is [Toggl](http://toggl.com)?\n[Toggl](http://toggl.com) is a time tracking app that I absolutely love to use. The interface is simple and the time reports are extremely useful. Toggl's API powers this script.\n\n## Installation and Configuration\nToggl CLI requires [python](http://www.python.org/). After you install python, execute the following:\n\n\t\tgit clone git://github.com/joequery/Toggl-CLI.git\n\t\tcd Toggl-CLI\n\t\tsudo python setup.py install\n\nNow edit the ~/.toggl file created for you and fill it in with your\ncredentials. Note that entering your password into this file is optional. If you don't, the script will request it at runtime. \n\n\n## Usage\n1. Create a new [Toggl Project](https://www.toggl.com/projects) via the web app.\n2. In the directory you plan on working in, create a .toggl_project file similar to the [toggl_project_example.txt file](https://github.com/joequery/Toggl-CLI/blob/master/toggl_project_example.txt). Specify a Project and optionally a Client in this file.\n\nNow simply execute\n\n\t/your/project/directory$ toggl\n\n\t----------------------\n\tToggl CLI\n\t----------------------\n\t1. Continue recent task\n\t2. Continue recent time entry\n\t3. New time entry\n\t4. Exit\n\n\tYour selection: \n\nYou will be prompted with a menu. You can continue a recent task, continue a recent time entry, or start a completely new time entry with your own description.\n\nAfter you make your selections from the menu, pressing enter will stop the timer and send the time to Toggl. Pressing CTRL+C will cancel the timer and NOT send the time to Toggl. This is useful in the event you get distracted or forget your timer is running!\n\nYou can immediately go check your Toggl dashboard and see the entry.\n\n## Technologies Used\n* [Requests](http://docs.python-requests.org/en/latest/index.html): HTTP for Humans\n* [Toggl API](https://www.toggl.com/public/api)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoequery%2Ftoggl-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoequery%2Ftoggl-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoequery%2Ftoggl-cli/lists"}