{"id":17941824,"url":"https://github.com/bradydouthit/cmdr","last_synced_at":"2026-02-03T00:03:04.965Z","repository":{"id":258843768,"uuid":"864654079","full_name":"BradyDouthit/cmdr","owner":"BradyDouthit","description":"CLI Tool that provides insights on how you use the terminal","archived":false,"fork":false,"pushed_at":"2024-11-25T16:52:16.000Z","size":1974,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-08T09:13:51.893Z","etag":null,"topics":["bash","cli","developer-tools","go","golang","wsl","zsh"],"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/BradyDouthit.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":"2024-09-28T19:48:36.000Z","updated_at":"2024-11-25T16:52:57.000Z","dependencies_parsed_at":"2024-12-21T21:41:31.666Z","dependency_job_id":"45126da6-350d-4c9d-8b9c-5d51db1324a5","html_url":"https://github.com/BradyDouthit/cmdr","commit_stats":null,"previous_names":["bradydouthit/cmdr"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/BradyDouthit/cmdr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BradyDouthit%2Fcmdr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BradyDouthit%2Fcmdr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BradyDouthit%2Fcmdr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BradyDouthit%2Fcmdr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BradyDouthit","download_url":"https://codeload.github.com/BradyDouthit/cmdr/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BradyDouthit%2Fcmdr/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261653262,"owners_count":23190424,"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":["bash","cli","developer-tools","go","golang","wsl","zsh"],"created_at":"2024-10-29T02:04:21.294Z","updated_at":"2026-02-03T00:03:04.938Z","avatar_url":"https://github.com/BradyDouthit.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# cmdr\n`cmdr` is a CLI tool with a goal of helping develpers understand their CLI usage in order to improve efficiency.\n\n\u003e [!NOTE]  \n\u003e  I hope to make this a tool developers like myself can use regularly to improve CLI usage a little every day. After all, we use the terminal so much we should be good at it. That said, I don't have much time for projects like this so it is pretty basic as of now but contributions are welcome (no strict rules or anything like that just make a PR)!\n\n## Examples\n\n1. **Top Commands**: By default, cmdr displays the top 5 most frequently used commands along with their usage count.\n\n   Example:\n   ```\n   $ cmdr\n   You have used git 150 times\n   You have used ls 120 times\n   You have used cd 100 times\n   You have used npm 80 times\n   You have used docker 50 times\n   ```\n\n2. **Customizable Results**: Use the `-t` or `--top` flag followed by a number to specify how many top commands you want to see.\n\n   Example:\n   ```\n   $ cmdr --top=10\n   ```\n   This will display the top 10 most frequently used commands.\n\n3. **Most Commonly Invalid Commands**: Use the or `invalid` command to see commands that you've attempted to run but don't exist or have failed.\n\n   Example:\n   ```\n   $ cmdr invalid --top=2\n   You have used gti 5 times but it does not exist\n   You have used sl 3 times but it does not exist\n   ```\n4. **Valid Commands**: Use the `valid` command to see commands that you've attempted to run but don't exist or have failed.\n\n   Example:\n   ```\n   $ cmdr valid\n   You ran go 143 times\n   You ran ls 124 times\n   You ran clear 105 times\n   You ran cd 96 times\n   You ran git 67 times\n   ```\n5. **Include or Exclude Arguments**: Use the `-a` or `--args` flag to include arguments. They are excluded by default.\n\n   Example:\n   ```\n   $ cmdr valid --args\n   You have used git push 10 times\n   You have used ls -l 5 times\n   ```\n6. **Combine Flags**: You can combine flags to get the desired output.\n\n   Example:\n   ```\n   $ cmdr valid --args --top=3 \n   You ran go run . 45 times\n   You ran cd .. 21 times\n   You ran npm run dev 14 times\n   ```\n\n## Installation\n\nTo install cmdr, you'll need to have Go installed on your system. Follow these steps:\n\n### Linux\n\n1. Clone the repository:\n   ```\n   git clone https://github.com/BradyDouthit/cmdr.git\n   cd cmdr\n   ```\n\n2. Build the project:\n   ```\n   go build -o cmdr\n   ```\n\n3. Add the compiled binary to your system's PATH:\n   ```\n   export PATH=$PATH:/path/to/cmdr\n   ```\n\n4. You can now run `cmdr` from anywhere in your terminal.\n\n### Windows\n\n1. Clone the repository:\n   ```\n   git clone https://github.com/BradyDouthit/cmdr.git\n   cd cmdr\n   ```\n\n2. Build the project:\n   ```\n   go build -o cmdr.exe\n   ```\n\n3. Add the directory containing `cmdr.exe` to your system's PATH\n\n4. You can now run `cmdr` from anywhere in your command prompt or PowerShell.\n\nNote: Make sure you have Go installed and properly configured on your system before following these steps.\n\n## Dependencies\n\ncmdr uses the following dependencies:\n- [Lipgloss](https://github.com/charmbracelet/lipgloss)\n- [switchboard](https://github.com/BradyDouthit/switchboard)\n\n## Currently Supported Terminal Emulators\n- `zsh`\n- `bash`\n\n## Contributing\nFeel free to contribute to cmdr by submitting a pull request or opening an issue. Your contributions and ideas are welcome!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbradydouthit%2Fcmdr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbradydouthit%2Fcmdr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbradydouthit%2Fcmdr/lists"}