Kelly Fox's dotfiles

These are the files I use to make the terminal a better place to live and work. :heart:

NOTE: I suggest using iTerm2 instead of the basic Terminal.app that comes with macOS. This will make your life on the command-line much easier. I also recommend supporting the author's work on Patreon.

Installation and Setup

Follow these directions to set up: https://developer.atlassian.com/blog/2016/02/best-way-to-store-dotfiles-git-bare-repo/

Then run the setup script:

$ setup.sh

Contents

Bash configuration files

.bash_profile

This is just a simple wrapper to load .bashrc and .bash_aliases.

.bashrc

The guts of my Bash setup. Here's what it does for you:

Functions

• serve lets you serve files using a simple web server in the current directory or a directory you specify. Usage: serve [documentroot] [port]. The documentroot defaults to the current directory and the port defaults to 8080.

• gh is a handy way to open the appropriate respository home page for projects on github.com via the command line. It works in three different modes:

  1. Without arguments and in a git repository, it will open the project home page on github.com
  2. With an argument of a project name, e.g. vim-vinegar, it will use the github API to find the URL of the repo most likely to be the one you're looking for, then opens that project's home page. Best used when feeling lucky.
  3. With an argument like username/repo, e.g. tpope/vim-vinegar, it will just open that repo

• gpr will open a pull request on github.com for the current branch if your current working directory is part of a local git repository.

Environment

• The main thing here is the git-repo-friendly prompt courtesy of bash-git-prompt. You may want to tweak the colors/symbols to your liking.

• The paths are set up for npm, node, go, and rbenv

• The GREP_OPTIONS are given some degree of sanity

• Your shell command history is constrained to 10000 commands

• Minor typos in cd commands will be auto-corrected when possible

• Several other things are initialized, e.g. virtualenv for Python, rbenv for Ruby, shell integration for iTerm2, bash-completion, and z.

.bash_aliases

• Make ls output more useful. Show all directories and use some color while doing it.

• Add the ll alias because I fell in love with it while using Linux systems

• "Clear the screen" just by typing c

• Add a couple of Rails and git aliases. The keystrokes you save may be your own.

.editrc

• Lets you use Ctrl-R to search backward through your entire command history

.inputrc

• Ignores case when tab-completing directories and filenames

• Disables the terminal bell

• Sets the default command-line editing mode to use vi keybinds instead of emacs, e.g. hit Esc-K to enter edit mode, then K again to move back through your command history or other vi command-mode commands to move and edit the current commmand.

• Shows all matches if your tab-completion would be ambiguous

Ruby configuration files

• .gemrc will not auto-install rubydocs when you install a gem

• .irbrc enables readline support, with a simple prompt, and enables awesome_print by default

• .pryrc adds some spiffy prompt stuff and a few convenience methods

Git configuration files

The .gitignore_global file specifies filename patterns to ignore globally, and is specified in the .gitconfig file.

The .gitconfig file defines several handy aliases:

• alias will add a new alias, e.g. git alias <alias> <original command>

• aliases will list all defined aliases

• br is short for branch

• changes is a more concise way of showing changed files and their status

• ci is short for commit

• co is short for checkout

• dc will show a diff of staged changes

• df is short for diff

• diffstat shows the number of additions/deletions per file

• history shows a complete diff history for each commit of a given file, e.g. git history package.json

• laststash shows the diff of the most recent stash against the current branch

• lc gives you an annotated log of changes to file(s) or the repo

• lg is a log with "graphing", showing merges and commits with lots of pretty colors 🌈

• new is a shorter way to create a new branch

• rm-merged will locally delete merged branches

• st is short for status

• undo-commit will undo the most recent commit

• whatis shows the commit message and date for a given sha commit hash

• whatsnew displays the most recent commit message, author, and date

• who shows the number of commits per committer. Will make use of a ~/.mailmap file if present to deduplicate and aggregate user names.

• whois gives you the full name and email address of a user if you provide a username

Homebrew

My Homebrew environment is preserved by way of Homebrew Bundle which uses the Brewfile to specify formulae and casks to be installed.

Scripts

These scripts are all located in the bin directory:

• download-bing-wallpaper.js will download the latest Bing Homepage image to your ~/Google Drive/Pictures/Bing directory and sets your primary desktop background to that image. Add it to a cron job for a fresh picture every day. Only the last 365 days of images are retained.

• colors shows a color palette so you can tweak your terminal colors

• excuse generates a programmer's excuse, for example:

  $ git commit -m "$(excuse)"

• gci, gco, gsq — git commit, checkout, and squash shortcuts

• logicprefs makes backups of your Logic Pro X preferences, and lets you restore them in case you happen to jack them up.

• mkbr creates a new git branch

• mkfavicon generates a favicon.ico file at all the different resolutions you probably will ever need

• mvbr renames a git branch

• ql is an easy way to use the macOS Quick Look functionality from the command line

• reassociate will associate source code file extensions with VS Code so you can Command-click a filename in iTerm2 (or double-click the file in Finder) and have it open in VS Code

• rmbr deletes a git branch, locally and remotely

• sayphrase says something using the built-in macOS speech synthesis. By default, it says a programming excuse (see above).

• setup.sh is the script to install/initialize the rest of my apps

• svg-to-data-uri.sh will take an SVG and URL-encode it for use in a data: URI. Full base64 encoding isn't necessary.

• updall updates Homebrew formulae/casks and global npm packages

Miscellaneous configuration files

.ptconfig.toml

Some settings for use with the pt command, a.k.a. The Platinum Searcher.

Feedback Welcome

If you see something that is broken, incorrect, or that could be improved, drop me a line or open an issue. Thanks! 😍