Go to file
Jero Sutlovic f45d25d81d Allow fetching trees with a slash in the tree name 2014-05-13 18:19:32 -04:00
icons Initial commit 2014-05-09 17:06:38 -07:00
lib Support Pjax 2014-05-11 10:14:25 -07:00
.gitignore Initial commit 2014-05-09 17:06:38 -07:00
LICENSE Initial commit 2014-05-09 11:15:20 -07:00
README.md Update readme 2014-05-12 22:47:49 -07:00
inject.css More CSS refactor 2014-05-11 21:25:29 -07:00
inject.js Allow fetching trees with a slash in the tree name 2014-05-13 18:19:32 -04:00
manifest.json Bump manifest version 2014-05-11 10:38:44 -07:00
screen_ext.png Update images 2014-05-09 17:14:43 -07:00
screen_token.png Update images 2014-05-09 17:14:43 -07:00

README.md

Octotree

Chrome extension to display GitHub code in tree format. Useful for developers who frequently read source in GitHub and do not want to download or checkout too many repositories. Features:

  • Easy-to-navigate code tree like IDEs
  • Fast browsing with pjax
  • Work with both public and private repositories

Install

  • Download and install Octotree from the Chrome store
  • Navigate to any GitHub project (or just refresh this page as an example)
  • The code tree should show as follows:

When extension is active

GitHub API Rate Limit

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 show the following screen to ask for your GitHub personal access token.

Enter personal access token

If you don't already have one, create one at this page. Then enter the generated token into the textbox and save.

Alternatively, you can always manually enter or update the token by following these steps:

  • Navigate to any GitHub page
  • Open the Chrome developer console
  • Execute the following line:
localStorage.setItem('octotree.github_access_token', 'REPLACE WITH TOKEN')

Contribution

There are several improvements that can be made to Octotree. Contribution is very welcome.

  • Hide sidebar when navigating to non-code pages like Issues, PRs...
  • Make the width of the sidebar resizable.
  • Allow docking sidebar to either the left or right side.
  • Allow users to enter access token any time.
  • Synchronize (two-way) between sidebar selection and GitHub selection.
  • Show progress indicator while the code tree or a file is being loaded (with Pjax). (Showing spinner in the toggle button?)

Credit

Icon by pstadler