{"id":13678655,"url":"https://github.com/jrnxf/gh-eco","last_synced_at":"2025-04-05T11:10:29.916Z","repository":{"id":37394822,"uuid":"491784345","full_name":"jrnxf/gh-eco","owner":"jrnxf","description":"🦎 gh cli extension to explore the ecosystem","archived":false,"fork":false,"pushed_at":"2024-09-03T14:14:49.000Z","size":35294,"stargazers_count":426,"open_issues_count":0,"forks_count":6,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-03-29T08:51:56.059Z","etag":null,"topics":["cli","gh-extension","github","go","golang","terminal","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/jrnxf.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":".github/CODE_OF_CONDUCT.md","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":"2022-05-13T06:34:50.000Z","updated_at":"2025-03-26T19:52:47.000Z","dependencies_parsed_at":"2024-06-18T22:36:41.669Z","dependency_job_id":"cb2ccd61-9f4e-4401-a9d3-2b92a8c05457","html_url":"https://github.com/jrnxf/gh-eco","commit_stats":{"total_commits":29,"total_committers":3,"mean_commits":9.666666666666666,"dds":0.06896551724137934,"last_synced_commit":"55e16b0b34062083b56a8c3964d50bfaba264545"},"previous_names":["coloradocolby/gh-eco","thatvegandev/gh-eco"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jrnxf%2Fgh-eco","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jrnxf%2Fgh-eco/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jrnxf%2Fgh-eco/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jrnxf%2Fgh-eco/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jrnxf","download_url":"https://codeload.github.com/jrnxf/gh-eco/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247325693,"owners_count":20920714,"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":["cli","gh-extension","github","go","golang","terminal","tui"],"created_at":"2024-08-02T13:00:56.631Z","updated_at":"2025-04-05T11:10:29.894Z","avatar_url":"https://github.com/jrnxf.png","language":"Go","funding_links":[],"categories":["GitHub","Go","⭐ Most Starred","cli","Dashboard/TUI"],"sub_categories":[],"readme":"# gh-eco\n\n🦎 gh extension to explore the ecosystem\n\n[![GitHub Go\nWorkflow](https://github.com/jrnxf/gh-eco/actions/workflows/ci.yml/badge.svg)](https://github.com/jrnxf/gh-eco/actions/workflows/ci.yml)\n[![License](https://img.shields.io/badge/License-MIT-default.svg)](./LICENSE.md) [![Github\nStars](https://img.shields.io/github/stars/jrnxf/gh-eco)](https://github.com/jrnxf/gh-eco/stargazers)\n\n![demo](https://github.com/jrnxf/assets/raw/main/gh-eco/demo.gif)\n\n## Installation\n\n1. Install the `gh` cli - see the [installation](https://github.com/cli/cli#installation)\n\n   _Installation requires a minimum version (2.0.0) of the the GitHub CLI that supports extensions._\n\n2. Install this extension:\n\n   ```sh\n   gh extension install jrnxf/gh-eco\n   ```\n\n\u003cdetails\u003e\n   \u003csummary\u003e\u003cstrong\u003eManual Installation\u003c/strong\u003e\u003c/summary\u003e\n\n\u003e If you want to install this extension manually, follow these steps:\n\n1. clone the repo\n\n   ```sh\n   # git\n   git clone https://github.com/jrnxf/gh-eco\n\n   # GitHub CLI\n   gh repo clone jrnxf/gh-eco\n   ```\n\n2. `cd` into it\n\n   ```sh\n   cd gh-eco\n   ```\n\n3. add dependencies and build it\n\n   ```sh\n   go get \u0026\u0026 go build\n   ```\n\n4. install it locally\n   ```sh\n   gh extension install .\n   ```\n   \u003c/details\u003e\n\n## Usage\n\nto run:\n\n```sh\ngh eco\n```\n\nto upgrade:\n\n```sh\ngh extension upgrade eco\n```\n\n## Roadmap\n\n**🎨 Custom Configurations**\n\nAllowing users to customize the colors of all displayed elements is definitely a priority. Right now\nthe colors used should be adaptive between standard light/dark themed terminal profiles, however\nit's entirely possible for the colors to still clash! Beyond colors, having the ability to select\nwhat elements are displayed, their ordering, custom keymaps, etc. would be awesome!\n\n**⚡️ Interactions**\n\nI'm intentionally releasing `gh-eco` while I still have ideas bouncing around in my head for what\ncould come next. There are some immediate limitations that I need to sort out. One of which is\ndealing with gh permissions. Right now all permissions are inherited from the `gh` cli, which only\nrequests a small subset of available scopes. One interaction I have built out is to follow/unfollow\nusers (see `feature/follow-users` branch), but the interaction is blocked due to missing scopes. I\nhaven't found any documentation or examples showcasing what extending permissions for a `gh`\nextension might look like, so I may need to contact support. I'd rather not make it a full blown\nstandalone app that requires it's own auth, as I think that might complicate things? If you have\nopinions please don't hesitate to reach out!\n\nOther interactions I think would be nice include:\n\n- searching for users and seeing results (i.e. perfect match not needed)\n  - searching for repos as well (possibly using `u/{username}` and `r/{repo}` to differentiate\n    searches)\n- \"see more\" option to view more than just pinned repos\n- viewing and/or filtering through a list of the followed/following users to jump to their profile\n- repo contributors and related stats\n- creative ways to show more user info while still keeping things clean (e.g. company, isHireable,\n  status, etc). These are easy to display but I'm intentionally keeping things lightweight for now\n- trending users, repos, etc.\n\n**🧪 Tests**\n\nTo date only a small amount of tests have been written. I feel comfortable writing tests for smaller\nutility functions, but I'd love to do more integration type testing on the underlying [Bubble\nTea](https://github.com/charmbracelet/bubbletea) implementation. If you have any experience with\nthis please feel free to open an issue / pull request and start the discussion!\n\n## Limitations\n\n- Misalignment can occur when emojis are present. Since emoji widths vary, I don't believe there is\n  any way to deal with this. Definitely reach out if you have any ideas.\n\n- Smaller terminal screens will almost definitely cause rendering issues. For `gh-eco` to work\n  properly make sure to give your terminal as much screen real estate as possible!\n\n## Contributing\n\nAll contributions are greatly appreciated!\n\nIf you have a suggestion that would make `gh-eco` better, please fork the repo and create a [pull\nrequest](https://github.com/jrnxf/gh-eco/pulls) or open an issue.\n\nSee the [open issues](https://github.com/jrnxf/gh-eco/issues) for a full list of proposed\nfeatures (and known bugs).\n\n## License\n\nDistributed under the MIT License. See [LICENSE.md](./LICENSE.md) for more information.\n\n## Acknowledgments\n\nCheck out these amazing projects that inspired `gh-eco`!\n\n- anything and everything by [charm.sh](https://charm.sh/)\n- [gh-dash](https://github.com/dlvhdr/gh-dash)\n\n## Follow\n\n[![github](https://img.shields.io/github/followers/jrnxf?style=social)](https://github.com/jrnxf)\n[![twitter](https://img.shields.io/twitter/follow/_jrnxf?color=white\u0026style=social)](https://twitter.com/_jrnxf)\n[![youtube](https://img.shields.io/youtube/channel/subscribers/UCEDfokz6igeN4bX7Whq49-g?style=social)](https://www.youtube.com/@jrnxf)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjrnxf%2Fgh-eco","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjrnxf%2Fgh-eco","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjrnxf%2Fgh-eco/lists"}