gh-eco
🦎 gh extension to explore the ecosystem
Installation
-
Install the
ghcli - see the installationInstallation requires a minimum version (2.0.0) of the the GitHub CLI that supports extensions.
-
Install this extension:
gh extension install jrnxf/gh-eco
Manual Installation
> If you want to install this extension manually, follow these steps: 1. clone the repo ```sh # git git clone https://github.com/jrnxf/gh-eco # GitHub CLI gh repo clone jrnxf/gh-eco ``` 2. `cd` into it ```sh cd gh-eco ``` 3. add dependencies and build it ```sh go get && go build ``` 4. install it locally ```sh gh extension install . ```Usage
to run:
gh ecoto upgrade:
gh extension upgrade ecoRoadmap
🎨 Custom Configurations
Allowing users to customize the colors of all displayed elements is definitely a priority. Right now the colors used should be adaptive between standard light/dark themed terminal profiles, however it's entirely possible for the colors to still clash! Beyond colors, having the ability to select what elements are displayed, their ordering, custom keymaps, etc. would be awesome!
⚡️ Interactions
I'm intentionally releasing gh-eco while I still have ideas bouncing around in my head for what
could come next. There are some immediate limitations that I need to sort out. One of which is
dealing with gh permissions. Right now all permissions are inherited from the gh cli, which only
requests a small subset of available scopes. One interaction I have built out is to follow/unfollow
users (see feature/follow-users branch), but the interaction is blocked due to missing scopes. I
haven't found any documentation or examples showcasing what extending permissions for a gh
extension might look like, so I may need to contact support. I'd rather not make it a full blown
standalone app that requires it's own auth, as I think that might complicate things? If you have
opinions please don't hesitate to reach out!
Other interactions I think would be nice include:
- searching for users and seeing results (i.e. perfect match not needed)
- searching for repos as well (possibly using
u/{username}andr/{repo}to differentiate searches)
- searching for repos as well (possibly using
- "see more" option to view more than just pinned repos
- viewing and/or filtering through a list of the followed/following users to jump to their profile
- repo contributors and related stats
- creative ways to show more user info while still keeping things clean (e.g. company, isHireable, status, etc). These are easy to display but I'm intentionally keeping things lightweight for now
- trending users, repos, etc.
🧪 Tests
To date only a small amount of tests have been written. I feel comfortable writing tests for smaller utility functions, but I'd love to do more integration type testing on the underlying Bubble Tea implementation. If you have any experience with this please feel free to open an issue / pull request and start the discussion!
Limitations
-
Misalignment can occur when emojis are present. Since emoji widths vary, I don't believe there is any way to deal with this. Definitely reach out if you have any ideas.
-
Smaller terminal screens will almost definitely cause rendering issues. For
gh-ecoto work properly make sure to give your terminal as much screen real estate as possible!
Contributing
All contributions are greatly appreciated!
If you have a suggestion that would make gh-eco better, please fork the repo and create a pull
request or open an issue.
See the open issues for a full list of proposed features (and known bugs).
License
Distributed under the MIT License. See LICENSE.md for more information.
Acknowledgments
Check out these amazing projects that inspired gh-eco!
Follow
