{"id":17575140,"url":"https://github.com/j4ng5y/comp-time-tracker","last_synced_at":"2025-08-10T22:34:31.622Z","repository":{"id":144282858,"uuid":"194417541","full_name":"j4ng5y/comp-time-tracker","owner":"j4ng5y","description":"a little time tracker for my personal comp time","archived":false,"fork":false,"pushed_at":"2019-07-02T16:54:48.000Z","size":2256,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2023-03-21T20:33:42.567Z","etag":null,"topics":["go","golang","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":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/j4ng5y.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-06-29T14:59:16.000Z","updated_at":"2024-06-19T10:42:01.377Z","dependencies_parsed_at":"2024-06-19T10:41:58.405Z","dependency_job_id":"319601c7-7728-4007-9f14-70aa949fa21f","html_url":"https://github.com/j4ng5y/comp-time-tracker","commit_stats":null,"previous_names":[],"tags_count":2,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j4ng5y%2Fcomp-time-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j4ng5y%2Fcomp-time-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j4ng5y%2Fcomp-time-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j4ng5y%2Fcomp-time-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/j4ng5y","download_url":"https://codeload.github.com/j4ng5y/comp-time-tracker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246207491,"owners_count":20740723,"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":["go","golang","time-tracker"],"created_at":"2024-10-21T22:22:51.543Z","updated_at":"2025-03-29T15:45:00.282Z","avatar_url":"https://github.com/j4ng5y.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Comp Time Tracker\n\nThis is a small little app that just helps me track my comp time while working on contracts.\n\n## Installation\n\n### Linux\n\n`sudo curl -o /usr/local/bin/ctt https://github.com/j4ng5y/comp-time-tracker/releases/download/2019.07.02/ctt-2019.07.02-linux-amd64`\n\n### OSX\n\n`sudo curl -o /usr/local/bin/ctt https://github.com/j4ng5y/comp-time-tracker/releases/download/2019.07.02/ctt-2019.07.02-darwin-amd64`\n\n### Windows\n\nSee building from source\n\n## Building From Source\n\n1. Have Go installed (you can get it [here](https://golang.org/dl/))\n2. Clone This Repository (`git clone https://github.com/j4ng5y/comp-time-tracker $GOROOT/src/github.com/j4ng5y/comp-time-tracker`)\n3. Navigate into the repository (`cd $GOROOT/src/github.com/j4ng5y/comp-time-tracker`)\n4. Build the tool (`CGO_ENABLE=1 go build -a -installsuffix cgo -o bin/ctt`)\n5. Install the tool:\n    * `ln -s $GOROOT/src/github.com/j4ng5y/comp-time-tracker/bin/ctt /usr/local/bin/ctt`\n    or\n    * `go install`\n\n## Usage\n\n```text\nA small app to track comp time\n\nUsage:\n  cct [flags]\n  cct [command]\n\nAvailable Commands:\n  delete      delete a comp time entry\n  help        Help about any command\n  new         create a new comp time entry\n  view        view comp time entries\n\nFlags:\n  -h, --help      help for cct\n      --version   version for cct\n\nUse \"cct [command] --help\" for more information about a command.\n```\n\n## Examples\n\n### Adding a new time entry\n\n#### new Usage\n\n```text\ncreate a new comp time entry\n\nUsage:\n  cct new [flags]\n\nFlags:\n  -d, --day int        the day of the entry\n  -h, --help           help for new\n  -m, --month int      the month of the entry\n  -n, --note string    a note for the entry\n  -T, --time int       the amount of time to add (positive integer) or subtract (negative integer) from the running total\n  -t, --title string   the title of the entry to create\n  -y, --year int       the year of the entry\n```\n\n#### new Commands Examples\n\n`ctt new -t \"\u003ctitle of entry\u003e\" -T \u003cminutes to add\u003e -m \u003cmonth of entry\u003e -d \u003cday of entry\u003e -y \u003cyear of entry\u003e -n \"\u003coptional: note\u003e\"`\n\nTo add a new 30 minute entry on July 1, 2019, it would like this:\n\n`ctt new -t \"This is a test entry\" -T 30 -m 07 -d 01 -y 2019 -n \"This test entry is used just to test the functionality of the ctt tool.\"`\n\nYou will see something to the effect of this:\n\n`2019/07/02 11:26:01 Entry {955c8c75-0d7d-48f2-a534-866abcdd1f31 7 1 2019 This is a test entry 30 This test entry is used just to test the functionality of the ctt tool.} added`\n\n### Viewing entries\n\n#### view Usage\n\n```text\nview comp time entries\n\nUsage:\n  cct view [flags]\n\nFlags:\n  -h, --help                  help for view\n  -s, --single-entry string   view a single entry\n  -D, --total-days            use this flag to view running time in days\n  -H, --total-hours           use this flag to view running time in hours\n  -M, --total-minutes         use this flag to view running time in minutes\n  -t, --total-only            use this flag if you only want to output the running total\n```\n\n#### view Command Examples\n\n*View All Entries*\n`ctt view`\n\nThis will output something like this (expanding on the previous example):\n\n```text\n------------------------------------------------------------------------------------------------------------------------------------------\n|               ENTRY_ID               |    DATE    |                 TITLE                | TIME |                 NOTE                 |\n------------------------------------------------------------------------------------------------------------------------------------------\n| 955c8c75-0d7d-48f2-a534-866abcdd1f31 | 07-01-2019 | This is a test entry                 |  30  | This test entry is used just to t... |\n------------------------------------------------------------------------------------------------------------------------------------------\nTOTAL:\nEntries: 1 | Comp Time (in Minutes): 30 | Comp Time (in Hours): 0.5 | Comp Time (in Days): 0.020833334 |\n```\n\n*View One Entry*\n`ctt view -s \"\u003cUUID\u003e\"`\n\nThis will output something like this (expanding on the previous example):\n\n```text\nID:    955c8c75-0d7d-48f2-a534-866abcdd1f31\nDate:  7-1-2019\nTitle: This is a test entry\nTime:  30\nNote:  This test entry is used just to test the functionality of the ctt tool.\n```\n\n*View Totals Only*\n**View In Minutes**: `ctt view -t -M`\n\nWhich outputs something like this (expanding on the previous example):\n\n```text\n2019/07/02 11:35:30 The current running total of all comp time is: 30 minutes\n```\n\n**View In Hours**: `ctt view -t -H`\n\nWhich outputs something like this (expanding on the previous example):\n\n```text\n2019/07/02 11:35:30 The current running total of all comp time is: 0 hours\n```\n\n**View In Days**: `ctt view -t -D`\n\nWhich outputs something like this (expanding on the previous example):\n\n```text\n2019/07/02 11:36:21 The current running total of all comp time is: 0 days\n```\n\n### Delete Entries\n\n#### delete Usage\n\n```text\ndelete a comp time entry\n\nUsage:\n  cct delete [flags]\n\nFlags:\n  -h, --help        help for delete\n  -i, --id string   the ID of the entry to delete\n```\n\n#### delete Command Examples\n\n`ctt delete -i \"\u003cUUID\u003e\"`\n\nWhich outputs something like this (expanding on the previous example):\n\n```text\n2019/07/02 11:39:01 Successfully removed entry with ID: 955c8c75-0d7d-48f2-a534-866abcdd1f31\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fj4ng5y%2Fcomp-time-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fj4ng5y%2Fcomp-time-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fj4ng5y%2Fcomp-time-tracker/lists"}