{"id":13395271,"url":"https://github.com/git-time-metric/gtm-terminal-plugin","last_synced_at":"2026-01-15T00:03:50.142Z","repository":{"id":56231766,"uuid":"67426852","full_name":"git-time-metric/gtm-terminal-plugin","owner":"git-time-metric","description":"Plugin for Bash or ZSH to be used with the Git Time Metric platform","archived":false,"fork":false,"pushed_at":"2020-11-19T08:39:23.000Z","size":6,"stargazers_count":15,"open_issues_count":4,"forks_count":6,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-07-31T17:23:44.221Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","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/git-time-metric.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":"2016-09-05T14:18:19.000Z","updated_at":"2021-09-21T17:46:22.000Z","dependencies_parsed_at":"2022-08-15T15:10:12.401Z","dependency_job_id":null,"html_url":"https://github.com/git-time-metric/gtm-terminal-plugin","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/git-time-metric/gtm-terminal-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/git-time-metric%2Fgtm-terminal-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/git-time-metric%2Fgtm-terminal-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/git-time-metric%2Fgtm-terminal-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/git-time-metric%2Fgtm-terminal-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/git-time-metric","download_url":"https://codeload.github.com/git-time-metric/gtm-terminal-plugin/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/git-time-metric%2Fgtm-terminal-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28439609,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T22:37:52.437Z","status":"ssl_error","status_checked_at":"2026-01-14T22:37:31.496Z","response_time":107,"last_error":"SSL_read: 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":[],"created_at":"2024-07-30T17:01:48.566Z","updated_at":"2026-01-15T00:03:50.125Z","avatar_url":"https://github.com/git-time-metric.png","language":"Shell","funding_links":[],"categories":["Plugins","Shell"],"sub_categories":["ZSH on Windows","Zinit (née zplugin)"],"readme":"\u003cdiv align=\"center\"\u003e\u003cimg src=\"https://cloud.githubusercontent.com/assets/630550/19619834/43c460dc-9835-11e6-8652-1c8fff91cf02.png\" alt=\"GTM Logo\" height=\"115\" width=\"275\"\u003e\u003c/div\u003e\n\u003cdiv align=\"center\"\u003eGit Time Metric\u003c/div\u003e\n\n### Terminal Git Time Metrics (GTM) plug-in\n\n#### Simple, seamless, lightweight time tracking for all your git projects\n\nGit Time Metrics (GTM) is a tool to automatically track time spent reading and working on code that you store in a Git repository. By installing GTM and using supported plug-ins for your favorite editors, you can immediately realize better insight into how you are spending your time and on what files.\n\n### Installation\n\nInstalling GTM is a two step process.  First, it's recommended you install the GTM executable that the plug-in integrates with and then install the Terminal GTM plug-in.  Please submit an issue if you have any problems and/or questions.\n\n1. Follow the [Getting Started](https://github.com/git-time-metric/gtm/blob/master/README.md) section to install the GTM executable for your operating system.\n2. To install the plugin download the shell script and `source gtm-plugin.sh` from either your .bashrc or .zshrc file. Also make sure the shell script is executable `chmod +x gtm-plugin.sh`.\n\n**Note** - to enable time tracking for a Git repository, you need to initialize it with `gtm init` otherwise it will be ignored by GTM. This is done via the command line.\n```\n\u003e cd /path/to/your/project\n\u003e gtm init\n```\n\nConsult the [README](https://github.com/git-time-metric/gtm/blob/master/README.md) and [Wiki](https://github.com/git-time-metric/gtm/wiki) for more information.\n\n**Note** - to use this plugin you must be on GTM version 1.1-beta.1 or higher.  To enable terminal tracking on an existing GTM initialized Git repository reinitialize with `gtm init`. To disable terminal tracking for a git repostiory use `gtm init --terminal=false`. \n\n# Features\n\n### Reporting\n\nThe time spent in the terminal is included when using the `gtm report` command.\n```\n\u003e gtm report\n\n72b7917 Output golang info for appveyor build\nSat Sep 10 21:30:27 2016 -0500 Michael Schenk\n\n       12m 50s  [r] Terminal\n        6m  0s  [r] script/appveyor-build.sh\n        2m 10s  [m] appveyor.yml\n       21m  0s\n```\n\n### Terminal Prompt\n\nThe total time spent for in-process work (uncommitted) is exported to `GTM_STATUS` environment variable. Your terminal prompt can be configured to display the current status.\n\n![](https://cloud.githubusercontent.com/assets/630550/18611230/afa8a248-7cf8-11e6-9436-ad5eccbfa500.png)\n\n### Command Line Interface\n\nUse the command line to report on time logged for your commits.\n\nHere are some examples of insights GTM can provide you.\n\n\u003cpre\u003e$ gtm report -today -author Schenk\n\n7129f00 \u003cb\u003eRemove post processing of status\u003c/b\u003e\nFri Sep 09 20:45:03 2016 -0500 \u003cb\u003egtm-vim-plugin\u003c/b\u003e Michael Schenk\n\n       20m 40s  53% [m] plugin/gtm.vim\n       18m  5s  46% [r] Terminal\n           15s   1% [m] .gitignore\n       39m  0s          \u003cb\u003egtm-vim-plugin\u003c/b\u003e \u003c/pre\u003e\n\n\u003cpre\u003e$ gtm report -format timeline-hours -last-week -author Schenk\n\n             \u003cb\u003e00.01.02.03.04.05.06.07.08.09.10.11.12.01.02.03.04.05.06.07.08.09.10.11.\u003c/b\u003e\n             ------------------------------------------------------------------------\n\u003cb\u003eSat Oct 08\u003c/b\u003e |                                                          ▃▃▃             |       \u003cb\u003e17m  0s\u003c/b\u003e\n             ------------------------------------------------------------------------\n\u003cb\u003eSun Oct 09\u003c/b\u003e |                      ▁▁▁   █████████▃▃▃██████▂▂▂   ▂▂▂                   |    \u003cb\u003e5h 33m  0s\u003c/b\u003e\n             ------------------------------------------------------------------------\n\u003cb\u003eTue Oct 11\u003c/b\u003e |                                                       ▂▂▂         ▂▂▂    |       \u003cb\u003e16m  0s\u003c/b\u003e\n             ------------------------------------------------------------------------\n\u003cb\u003eFri Oct 14\u003c/b\u003e |                                     ▂▂▂                                  |       \u003cb\u003e13m  0s\u003c/b\u003e\n             ------------------------------------------------------------------------\n\u003cb\u003eSat Oct 15\u003c/b\u003e |                            ███▇▇▇███▇▇▇███▁▁▁▇▇▇▂▂▂▁▁▁▃▃▃▆▆▆███▇▇▇       |    \u003cb\u003e8h 11m  0s\u003c/b\u003e\n             ------------------------------------------------------------------------\n                                                                                          \u003cb\u003e14h 30m  0s\u003c/b\u003e \u003c/pre\u003e\n\nGTM is automatic, seamless and lightweight.  There is no need to remember to start and stop timers.  It runs on occasion to capture activity triggered by your editor.  The time metrics are stored locally with the git repository as [Git notes](https://git-scm.com/docs/git-notes) and can be pushed to the remote repository. \n\n# Support\n\nTo report a bug, please submit an issue on the [GitHub Page](https://github.com/git-time-metric/gtm-vim-plugin/issues)\n\nConsult the [README](https://github.com/git-time-metric/gtm/blob/master/README.md) and [Wiki](https://github.com/git-time-metric/gtm/wiki) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgit-time-metric%2Fgtm-terminal-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgit-time-metric%2Fgtm-terminal-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgit-time-metric%2Fgtm-terminal-plugin/lists"}