Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including check-it-out with all npm packages installed. Try it out:

var checkItOut = require("check-it-out")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

check-it-out v1.0.2

Easy git checkout CLI tool.

Check It Out Logo

first-timers-only Build Status Downloads per week npm version GitHub version


Check it out, before you checkout.

Check It Out lets you interactively see and choose what branch you want to check out without the hassle of trying to type out a long or confusing branch name. Checking out branches just got even simpler!

Requirements

Node >= v4.0

Git - Required for core features

Compatibility

Check It Out currently has known issues with Windows. Some users have reported it working while others have reported that it does not. It is built and tested mostly in an Arch Linux environment with some user testing on MacOS and other Linux distributions. We're currently looking for help figuring out why Check It Out is unstable on Windows. See CIO-128

Installation

We're on NPM!

npm install -g check-it-out

Installing from source

Fork or clone the repository

git clone https://github.com/jwu910/check-it-out.git

Navigate to your repository directory and run

npm install

Create a symbolic link to the entry point

In the repository directory run:

npm link

Usage

To get started, just run:

checkit

or

cio

Check It Out Usage

Features

See a git log for the highlighted ref by pressing SPACE

Quick Git Log!

CommandsDescription
j/k, /Navigate the list
h/l, /Previous/Next remote
Ctrl+rRefresh list with a fetch and prune
enterSelect highlighted item
spaceGit log
q, Ctrl+c, escQuit

Settings

Git log argument validation is planned, but not finished. Currently, if the git log fails, space should not crash the app, but the process should not spawn at all.

Configurable settings can be found at ~/.config/configstore/check-it-out.json

Options include:

  • gitLogArguments
    • Type: Array
    • Default: ['--color=always', '--pretty=format:%C(yellow)%h %Creset%s%Cblue [%cn] %Cred%d ']
    • Array of strings of valid git log arguments.
  • sort
    • Type: String
    • Default: -committerdate
    • Sort references by latest commit date. Value must be a valid sort key or Check It Out will break on start.
  • themeColor
    • Type: String
    • Default: #FFA66D
    • A hex color code to style Check It Out

To reset Check It Out to its original configurations listed above, start with the flag --reset-config:

checkit --reset-config

Contributing

Please refer to the Contributing Guidelines before contributing.

See the rest of our issues

Contributors

Many thanks to all those who have helped!

| [
Brandon Benefield](https://www.bbenefield.com)
[📖](https://github.com/jwu910/check-it-out/commits?author=bbenefield89 "Documentation") | [
Aaron Casanova](https://github.com/casyjs)
[💻](https://github.com/jwu910/check-it-out/commits?author=casyjs "Code") | [
Drew Brokke](https://github.com/drewbrokke)
[💻](https://github.com/jwu910/check-it-out/commits?author=drewbrokke "Code") [🤔](#ideas-drewbrokke "Ideas, Planning, & Feedback") | [
Johanna Tchon](https://github.com/jotchon)
[💻](https://github.com/jwu910/check-it-out/commits?author=jotchon "Code") | [
Jenell Pizarro](https://www.jenellpizarro.com/)
[📖](https://github.com/jwu910/check-it-out/commits?author=nellarro "Documentation") | [
Rebecca Hong](http://www.linkedin.com/in/rehong)
[🎨](#design-rebeccahongsf "Design") | [
Jesse Ma](https://github.com/jma26)
[💻](https://github.com/jwu910/check-it-out/commits?author=jma26 "Code") | | :---: | :---: | :---: | :---: | :---: | :---: | :---: | | [
Kien Do](https://github.com/kienD)
[💬](#question-kienD "Answering Questions") [🐛](https://github.com/jwu910/check-it-out/issues?q=author%3AkienD "Bug reports") [🤔](#ideas-kienD "Ideas, Planning, & Feedback") | [
Vu Tran](http://twitter.com/tranvu)
[💬](#question-vutran "Answering Questions") [📖](https://github.com/jwu910/check-it-out/commits?author=vutran "Documentation") [🤔](#ideas-vutran "Ideas, Planning, & Feedback") [📢](#talk-vutran "Talks") | [
Efrain 'Rain' Rivas](https://github.com/rainrivas)
[💬](#question-rainrivas "Answering Questions") [🐛](https://github.com/jwu910/check-it-out/issues?q=author%3Arainrivas "Bug reports") [💡](#example-rainrivas "Examples") [🚇](#infra-rainrivas "Infrastructure (Hosting, Build-Tools, etc)") [💻](https://github.com/jwu910/check-it-out/commits?author=rainrivas "Code") [📖](https://github.com/jwu910/check-it-out/commits?author=rainrivas "Documentation") | [
Phuc Le](https://phuchle.com)
[💬](#question-phuchle "Answering Questions") [📢](#talk-phuchle "Talks") | [
Can Cellek](http://www.cancellek.com)
[💻](https://github.com/jwu910/check-it-out/commits?author=excalith "Code") [📖](https://github.com/jwu910/check-it-out/commits?author=excalith "Documentation") | [
Aras Atasaygin](https://github.com/arasatasaygin)
[🎨](#design-arasatasaygin "Design") | [
Donald Lika](https://www.linkedin.com/in/donaldlika1)
[💻](https://github.com/jwu910/check-it-out/commits?author=DonaldLika "Code") | | [
Connor Markwell](https://github.com/9reeno)
[💻](https://github.com/jwu910/check-it-out/commits?author=9reeno "Code") |

Acknowledgements

Thanks to @kiend for the inspiration and motivation to finish this project. Check This Out.

Logo Design by @arasatasaygin @openlogos

License

MIT @ Joshua Wu

Metadata

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free