Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Gabo’s dotfiles

This is a work in progress!

I maintain this repo as my dotfiles. You're quite welcome to make suggestions, however I may decline if it's not of personal value to me. If you're starting off also consider forking one of these other other great setups

These are the base dotfiles that I use. For more specific local needs I use the .local files described in the Local Settings section.

Setup / Installation

The setup process in based on alrra's dotfiles setup. To setup the dotfiles just run the appropriate snippet in the terminal:

(⚠️ DO NOT run the setup snippet if you don't fully understand what it does. Seriously, DON'T!)

OS Snippet
OS X bash -c "$(curl -LsS"
Ubuntu bash -c "$(wget -qO -"

That's it!

The setup process will:

Setup process in action
Setup process on OS X Setup process on Ubuntu


Local Settings

The dotfiles can be easily extended to suit additional local requirements by using the following files:


If the ~/.gitconfig.local file exists, it will be automatically included after the configurations from ~/.gitconfig, thus, allowing its content to overwrite or add to the existing git configurations.

Note: Use ~/.gitconfig.local to store sensitive information such as the git user credentials, e.g.:

    name = Gabo Esquivel
    email =


If the ~/.vimrc.local file exists, it will be automatically sourced after ~/.vimrc, thus, allowing its content to add or overwrite the settings from ~/.vimrc.


Same as ~/.vimrc.local but for ~/.gvimrc.

Do this: OSX

Remap caps-lock to escape with Seil

The escape key is the single most used key in vim. Old keyboards used to have Escape where Tab is today. Apple keyboards are the worst with their tiny Esc keys. But all this is fixed by remapping Caps to Escape. If you're hitting a small target in the corner, you are slowing yourself down considerably, and probably damaging your hands with repetitive strain injuries.

StackOverflow: Using Caps Lock as Esc in Mac OS X : Walk-Through

Speed Up your Key Repeat with Karabiner

Basic Configuration > Key Repeat

karabiner setting

Set up a system wide hotkey for iTerm (Keys=>Hotkey)

Recommended Cmd-Escape, which is really Cmd-Capslock.

iTerm2 offers a special terminal window that is always available with a single keystroke. This window is called the "hotkey window" and is most commonly used for occasional administrative tasks. To enable this feature, go to Preferences > Keys. Enable "Show/Hide iTerm2 with a system-wide hotkey". Click in the field and enter the key combination you'd like to use. Then check "hotkey toggles a dedicated window with profile:". A new profile will be created that is optimized for the feature. Pressing the hotkey will drop a terminal window down from the top of the screen, and pressing it again (or clicking in any other window) causes it to disappear.

in MacVim, uncheck Prefer native fullscreen under Advanced settings

Same as iTerm. The Lion style spaces navigation slows everything down for no reason.


To update the dotfiles you can either run the dotfiles script or, if you want to just update one particular part, run the appropriate os script.


Suggestions/improvements welcome!

Contributions are always welcome in the form of pull requests with explanatory comments.


If you decide to fork this project, don't forget to substitute my username with your own in the setup snippets and in the dotfiles script.


Inspiration and code was taken from many sources, including:

If you're interested in the philosophy behind why projects like these are awesome, you might want to holman's post on the subject.



The code is available under the MIT license.


👜 dotfiles for OS X and Ubuntu







No releases published


No packages published