GitCodeTree

Go to file

Buu Nguyen 2980220b96 Workaround to support keyboard navigation in tree		2015-03-06 13:03:56 -08:00
dist	Bump version and create dist packages	2015-01-21 15:44:27 -08:00
docs	Remove token.png	2014-07-25 16:58:41 -07:00
icons	Continue: support GitHub Enterprise	2014-07-11 19:16:33 -07:00
libs	Update to all latest libraries & bump version	2015-03-06 11:14:57 -08:00
src	Workaround to support keyboard navigation in tree	2015-03-06 13:03:56 -08:00
test	Make firefox test work	2014-12-22 18:14:43 -08:00
.editorconfig	Add editorconfig	2014-06-06 17:38:50 -07:00
.gitignore	Add option to show Octotree in non-code page	2014-11-24 19:05:03 -08:00
.jshintrc	Initial test suite	2014-12-16 14:40:07 -08:00
LICENSE	Initial commit	2014-05-09 11:15:20 -07:00
README.md	Bump version and create dist packages	2015-01-21 15:44:27 -08:00
gulpfile.js	Update `test` task to invoke `build` beforehand	2015-03-06 11:13:47 -08:00
package.json	Update to all latest libraries & bump version	2015-03-06 11:14:57 -08:00

README.md

Octotree

Browser extensions (Chrome, Firefox, Safari and Opera) 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
Customizable hotkey
Support private repositories (see instructions)
Support GitHub Enterprise (Chrome and Opera only, see instructions)

Install on Chrome and Firefox

Download and install Octotree from Chrome Web Store or Mozilla Add-ons Store
Navigate to any GitHub repository (or just refresh this page as an example)
The code tree should show on the left-hand side of the screen

Install on Safari and Opera

You can install the prebuilt extensions located in the dist folder. For security reason, only download Octotree from this location.

Safari: drag safari.safariextz to the browser and follow the instructions
Opera: drag opera.nex to the browser and follow the instructions

GitHub access token

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:

You access a private repository
You exceed the rate limit of unauthenticated requests

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_repo and repo (if you need access to private repositories).

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

Navigate to any GitHub repository
Open the Chrome (or Safari, Firefox) developer console
Execute the following line:

localStorage.setItem('octotree.github_access_token', 'REPLACE WITH TOKEN')

Note: if you use GitHub Enterprise, each site will need its own access token. Therefore, Octotree stores access token on a per-site basis.

GitHub Enterprise

By default, Octotree only works on github.com. To support GitHub Enterprise on Chrome or Opera, you must grant Octotoree sufficient permissions. Follow these steps to do so: