git brws is a command line tool to open a repository, file, commit, diff, pull request or issue in your web browser from command line. 'brws' is an abbreviation of 'browse'.

Features:

• Opens a page of
  • Repository (e.g.)
  • File (e.g.)
  • Commit (e.g.)
  • Diff (e.g., e.g.)
  • Pull request (only for GitHub and GitHub Enterprise) (e.g.)
  • Issue (e.g.)
  • Website (e.g.)
    • Homepage of the repository for GitHub or GitHub Enterprise, GitLab pages, Bitbucket Cloud
• Supports following services
  • GitHub
  • Bitbucket
  • GitHub Enterprise
  • GitLab
• Prefers commit-specific page URL (permlink)
• Available on Linux, macOS and Windows

git brws is available on Linux, macOS and Windows.

• With Homebrew

$ brew tap "rhysd/git-brws" "https://github.com/rhysd/git-brws"
$ brew install git-brws

It installs git-brws to /usr/local/bin and git-brws.1 to /usr/local/share/man/man1. This is recommended way for installation on macOS since updating to the new version is easy.

• With cargo

$ cargo install git-brws

• As a single executable binary

Pre-built binary executables are available at release page for macOS (64bit), Linux (64bit, 32bit) and Windows (64bit, 32bit). Download and unarchive the binary then put the executable in $PATH.

Manpage for man command is available. Please find git-brws.1 in the unarchived directory or download it from here and copy it to the man directory in your system (e.g. /usr/local/share/man/man1/).

Note: git brws --help only works when it is installed.

Usage: git brws [Options] {Args}

Options:
    -r, --repo REPO     Shorthand format (repo, user/repo, host/user/repo) or
                        Git URL you want to see. When only repo name is
                        specified, most popular repository will be searched
                        from GitHub
    -b, --branch BRANCH Branch name to browse. Default value is current branch
    -d, --dir PATH      Directory path to the repository. Default value is
                        current working directory.
    -R, --remote REMOTE Remote name (e.g. origin). Default value is a remote
                        the current branch is tracking. If current
                        branch tracks no branch, it falls back to 'origin'.
    -u, --url           Output URL to stdout instead of opening in browser
    -p, --pr            Open pull request page instead of repository page
    -w, --website       Open website page instead of repository page (homepage
                        URL for GitHub, GitLab pages, Bitbucket Cloud)
    -h, --help          Print this help
    -v, --version       Show version

• Repository at current directory

$ git brws

• develop branch

$ git brws -b develop

• origin remote of develop branch

$ git brws -r origin -b develop

• @rhysd's 'Shiba' repository

$ git brws -r rhysd/Shiba

• Most popular react repository on GitHub

$ git brws -r react

It will open https://github.com/facebook/react.

Note: When only repository name is specified for -r option, git-brws searches GitHub with query {repo} in:name and opens the best-matched repository page.

• Specify directory of repository

$ git brws -d ~/.go/src/github.com/rhysd/dot-github

• File of current branch of current remote

$ git brws ./some/file.txt

• Line of the file

$ git brws ./some/file.txt#L123

Note: The L can be omit.

• Range from line to line of the file

$ git brws ./some/file.txt#L123-L126

Note: The L can be omit.

• HEAD page of current repository

$ git brws HEAD

• Diff between HEAD and HEAD~3

$ git brws HEAD~3..HEAD

• Diff between 113079b and 60024ab

$ git brws 60024ab..113079b

In addition to .., diff with ... is supported.

• Diff between branchB and the merge base commit from branchB into branchA

$ git brws branchA...branchB

If you don't know the difference between .. and ..., please read git diff --help.

Note: Only GitHub and GitHub Enterprise support .... For GitLab, only ... is available.

• Pull request page of current branch of current repository

$ git brws --pr

• Pull request page of specific branch of specific repository

# Specify my forked repository
$ git brws --pr --repo rhysd/rust.vim -b async-contextual-keyword

# Or specify original repository
$ git brws --pr --repo rust-lang/rust.vim -b async-contextual-keyword

Note: Currently only GitHub and GitHub Enterprise are supported.

Note: If you have created multiple pull requests at the same repository with the same branch name, the command may not open a pull request page you want.

# Website for current repository
$ git brws --website

With --repo option, arbitrary repository's website can be opened.

# Opens https://reactjs.org
$ git brws --website --repo react

It opens a website for the repository.

• For GitHub, URL for 'homepage' configuration of the repository if it's set. Otherwise https://{user}.github.io/{repo}
• For GitHub Enterprise, https://pages.{host}/{user}/{repo} or https://{host}/pages/{user}/{repo} depending on your GitHub Enterprise configuration of subdomain isolation
• For GitLab, GitLab Pages
• For Bitbucket, Bitbucket Cloud

• Issue #8

$ git brws '#8'

Note: # is usually used for a line comment in major shells. Please quote the argument

With -u option, git brws outputs URL to stdout.

For example, in Vim, you can write your repository URL to your text instantly.

:r!git brws -u

And below can open editing file in your browser.

:!git brws %

Some environment variables are available to customize behavior of git-brws.

• hub browse
• git open
• open-browser-github.vim
• git browse

Distributed under the MIT license.

Please see the project page.

Repository for git-brws is hosted at GitHub.

To watch file changes and run linter/tests automatically:

cargo install cargo-watch
cargo watch -x clippy -x test

Some tests require GitHub API access token. To run full tests:

export GITHUB_TOKEN=xxxxxxxxxxx
cargo test

cargo test and cargo clippy are automatically run on pushing to remote by cargo-husky. But some tests fail when the remote tracking branch does not exist. When you create a new branch, please use --no-verify. Please do not use --no-verify otherwise.

git checkout -b new-branch
git push -u origin new-branch --no-verify

To update manpage file git-brws.1 and docs/index.html, please edit git-brws.1.ronn and generate git-brws.1 automatically with docs/gen.sh script. ronn is necessary as a dependency.

gem install ronn
./docs/gen.sh

To update Homebrew formula file, please use HomebrewFormula/update.sh.

For example, when updating to 0.9.2:

./HomebrewFormula/update.sh 0.9.2