{"id":16371609,"url":"https://github.com/tom-draper/clockin","last_synced_at":"2026-04-29T09:36:34.838Z","repository":{"id":59903088,"uuid":"539971413","full_name":"tom-draper/clockin","owner":"tom-draper","description":"A command-line tool for tracking time spent working.","archived":false,"fork":false,"pushed_at":"2022-12-09T14:47:15.000Z","size":3738,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-24T17:40:54.379Z","etag":null,"topics":["cli-app","command-line","command-line-tool","go","golang","mysql","productivity","session-tracking","time-management","tracking","tui"],"latest_commit_sha":null,"homepage":"","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/tom-draper.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}},"created_at":"2022-09-22T12:30:51.000Z","updated_at":"2023-07-18T09:16:41.000Z","dependencies_parsed_at":"2023-01-25T14:10:11.005Z","dependency_job_id":null,"html_url":"https://github.com/tom-draper/clockin","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tom-draper/clockin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tom-draper%2Fclockin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tom-draper%2Fclockin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tom-draper%2Fclockin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tom-draper%2Fclockin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tom-draper","download_url":"https://codeload.github.com/tom-draper/clockin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tom-draper%2Fclockin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32420350,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T06:29:02.080Z","status":"ssl_error","status_checked_at":"2026-04-29T06:29:00.631Z","response_time":110,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["cli-app","command-line","command-line-tool","go","golang","mysql","productivity","session-tracking","time-management","tracking","tui"],"created_at":"2024-10-11T03:09:01.588Z","updated_at":"2026-04-29T09:36:34.808Z","avatar_url":"https://github.com/tom-draper.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n\t\u003cimg width=\"550px\" src=\"https://user-images.githubusercontent.com/41476809/192119791-831cec36-dab0-4cb0-afc1-1ba12389475f.png\"\u003e\n\u003c/p\u003e\n\nA command-line tool for tracking your working periods. Start and stop the timer with two simple commands, and then open the built-in statistical summary to identify patterns and trends!\n\n## Getting Started\n\n### Install Dependencies\n\nA local \u003ca href=\"https://dev.mysql.com/downloads/mysql/\"\u003eMySQL\u003c/a\u003e server is required by clockin to store session data on your machine. During setup, ensure you make note of your MySQL username and password and copy them into the .env file or enter them straight into the command line during the first run of the program.\n\nDownload Go dependencies with:\n\n```bash\ngo mod download\n```\n\n### Build\n\nCompile the program on your machine with:\n\n```bash\ngo build clockin.go\n```\n\nTo make the executable runnable from anywhere, add the directory as a PATH environment variable.\n\n## How to Use\n\n### Starting a work session\n\nTo start recording a new work session, run:\n\n```bash\nclockin start\n```\n\nYou can keep track of multiple work sessions running at once by providing a name identifier:\n\n```bash\nclockin start homework\n```\n\n### Finishing a work session\n\nTo finish recording for all currently running work sessions, run:\n\n```bash\nclockin stop\n```\n\nYou can specify a particular work session by its name identifier:\n\n```bash\nclockin stop homework\n```\n\n### Show running sessions\n\nTo list all currently running work sessions, run:\n\n```bash\nclockin running\n```\n\n### Reset data\n\nTo delete all stored data, run:\n\n```bash\nclockin reset\n```\n\n### Statistics\n\nA statistical summary of how you've spent your time working can be displayed by running:\n\n```bash\nclockin stats\n```\n\u003c!---\n### Config\n\nconfig.json contains configurable settings that affect the way clockin works.\n\n#### timeout\n\nAn integer upper limit on the number of hours that can be considered a single working session. Once the given number of hours is reached, the work session will terminate. This can be helpful if you ever forget to finish a session. A value of null represents no upper limit, and a working session will only end once the finish command is run or the machine is shutdown. Defaults to null.\n\n#### discardOnTimeout\n\nA boolean value on whether a work session is discarded if the timeout limit is reached. Defaults to false.\n--\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftom-draper%2Fclockin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftom-draper%2Fclockin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftom-draper%2Fclockin/lists"}