Extension to show code tree for GitHub
Features:
* Easy-to-navigate code tree like IDEs
* Support private repositories
* Support GitHub and GitLab Enterprise
Learn more about Octotree settings:
Browser extension (Chrome, Firefox, Opera and Safari) to show a code tree on GitHub. Awesome for exploring project source without having to pull every single repository to your machine. Features:
Support GitHub Enterprise (Chrome and Opera only, see instructions)
GitLab is no longer supported: As of version 2.1.0, Octotree no longer supports GitLab. There are 2 reasons for this. First, GitLab has changed so much recently that it would take a lot of effort to keep Octotree up to date. Second, the GitLab team has told me they would build a tree feature in GitLab itself. I can't afford working on something knowing my effort will be irrelevant any time soon. That being said, if anyone wants to work on supporting the new GitLab, I'll gladly accept contributions to add back GitLab support.
Prebuilt packages are available in the dist folder. For security reason, only download Octotree from this location.
Note: Firefox 43+ requires add-ons to be signed. Therefore, you should install Octotree from the Mozilla store. For some reason if you want to install the prebuilt package instead, you have to disable sign-check.
Settings
Access Token
Note for the paranoids (like me!): Octotree stores access tokens in your browser local storage and never transmits it anywhere. If you want to verify, check out the source, starting with this line.
GitHub
Octotree uses GitHub API to retrieve repository metadata. By default, it makes unauthenticated requests to the GitHub API. However, there are two situations when requests must be authenticated:
When that happens, Octotree will ask for your GitHub personal access token. If you don't already have one, create one, then copy and paste it into the textbox. Note that the minimal scopes that should be granted are public_repoand repo (if you need access to private repositories).
Bitbucket (experimental)
Octotree uses Bitbucket API to retrieve repository metadata. By default, Octotree asks for your Bitbucket App password. If you don't already have one, create one (the minimal requirement is Repositories's Read permission), then copy and paste it into the textbox.
Note that Octotree extracts your username from the current page to invoke the Bitbucket API. If fail to do so, Octotree will ask you for a token update, you just need to prepend your username to the token, separated by a colon, i.e. USERNAME:TOKEN.
Enterprise URLs
By default, Octotree only works on github.com. To support enterprise version (Chrome and Opera only), you must grant Octotree sufficient permissions. Follow these steps to do so:
Go to any GitHub repo
Open the Octotree settings panel
Fill in the GitHub Enterprise URLs textbox, one URL per line
Remember sidebar visibility: if checked, show or hide Octotree based on its last visibility.
Show in non-code pages: if checked, allow Octotree to show in non-code pages such as Issues and Pull Requests.
Load entire tree at once: if checked, load and render the entire code tree at once. To avoid long loading, this should be unchecked if you frequently work with very large repos.
No comments:
Post a Comment