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

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! 😍

kfox/dotfiles