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.
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
This is just a simple wrapper to load .bashrc
and .bash_aliases
.
The guts of my Bash setup. Here's what it does for you:
-
serve
lets you serve files using a simple web server in the current directory or a directory you specify. Usage:serve [documentroot] [port]
. Thedocumentroot
defaults to the current directory and the port defaults to8080
. -
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:- Without arguments and in a git repository, it will open the project home page on github.com
- 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. - 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.
-
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
, andrbenv
-
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.
-
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.
- Lets you use Ctrl-R to search backward through your entire command history
-
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
-
.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
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 forbranch
-
changes
is a more concise way of showing changed files and their status -
ci
is short forcommit
-
co
is short forcheckout
-
dc
will show a diff of staged changes -
df
is short fordiff
-
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 forstatus
-
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
My Homebrew environment is preserved by way of
Homebrew Bundle which
uses the Brewfile
to specify formulae and casks to be installed.
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 afavicon.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
Some settings for use with the pt
command, a.k.a. The Platinum
Searcher.
If you see something that is broken, incorrect, or that could be improved, drop me a line or open an issue. Thanks! ๐