dotfiles

This is my dotfiles repo. You're welcome to use it, but I would highly recommend setting up an environment that is tailored for yourself. To build this, I borrowed from a lot of different repos and did a lot of tweaking. I'd recommend you do the same.

I especially recommend against copying anything that configures vim or tmux. I've been experimenting with these but have not landed on something I'm super happy with.

Files

I don't know what the typical setup is and I'm sure I could improve on this, but here's a short explanation of what the files included are:

• install.sh: This runs all of the install scripts in install-scripts/
• brew-list.sh: Generates the list of stuff in my Brewfile for the readme
• Brewfile: All my Brew stuff
• apps/: Config for various applications that isn't well represented by dotfile stuff
• bin/: Intentionally left empty and gitignored, I have some private scripts in there
• home/: Everything in here gets symlinked into ~
• install-scripts: Various scripts to get my environment up and running

home/.aws/

This contains some basic AWS config for the official AWS CLI.

home/.aliases

• ls: Aliased to the excellent exa
• aliases: Prints out all aliases and functions
• apk-version: Reads the version number of an APK located at $APK_DIR/android-release.apk
• point-master: Runs git fetch and then checks out the head commit. I only use this for submodules
• ipl: Run yarn install without touching the lockfile
• build-android: Just an easy alias to clean + build Android projects
• s: git status
• d: git diff
• less: Less, but with syntax highlighting
• more: less
• hcat: Cat, but with syntax highlighting
• ag: Make ag include ~/.ignore by default
• J: Pipe something to jq. Example: cat thing.json J

home/.exports

This is just some basic environment setup and stuff that I didn't want to stick elsewhere.

home/.functions

• android-version: Prints the version of an APK at the specified path
• ctx: Without a parameter provided, lists kubectl contexts. With a parameter provided, switches to that context.
• reload-zsh: Clears all functions/aliases and then sources .zshrc
• fh: Fuzzy search of recent command history, selecting one loads it into the prompt
• fco Fuzzy search of git branches and tags, selecting one checks it out
• fshow: Fuzzy search of git logs

home/.gitconfig

Mostly only useful for the aliases:

• git graph: Git logs output as a colorful graph
• git rbc: git rebase --continue
• git co: git checkout
• git ec: git config --global -e (opens the config file to be edited)
• git ds: git diff --staged
• git local-branches: Prints a list of branches that have not been pushed
• git cp: git cherry-pick
• git cpc: git cherry-pick --continue
• git cpa: git cherry-pick --abort
• git smu: git submodule update
• git smui: git submodule update --init
• git smuir: git submodule update --init --recursive
• git logs: Git logs in the format I prefer reading them
• git ptags: git push && git push --tags
• git fetch-master: Does the same thing as the point-master from .aliases
• git cm: git commit -m

home/.taskwarrior_fns

These are just functions specific to Taskwarrior that I wanted to separate out.

Brewfile

Here's an auto-generated list of the stuff in my Brewfile. I haven't figured out how to parse out casks or mas installs.

• asciinema: Record and share terminal sessions
• automake: Tool for generating GNU Standards-compliant Makefiles
• awscli: Official Amazon AWS command-line interface
• bat: Clone of cat(1) with syntax highlighting and Git integration
• bazel: Google's own build tool
• boost: Collection of portable C++ source libraries
• broot: New way to see and navigate directory trees
• buku: Powerful command-line bookmark manager
• carthage: Decentralized dependency manager for Cocoa
• ceres-solver: C++ library for large-scale optimization
• cgal: Computational Geometry Algorithms Library
• cheat: Create and view interactive cheat sheets for *nix commands
• cmake: Cross-platform make
• cocoapods: Dependency manager for Cocoa projects
• coreutils: GNU File, Shell, and Text utilities
• desk: Lightweight workspace manager for the shell
• dex2jar: Tools to work with Android .dex and Java .class files
• diff-so-fancy: Good-lookin' diffs with diff-highlight and more
• dive: A tool for exploring each layer in a docker image
• docker-clean: Clean Docker containers, images, networks, and volumes
• eigen: C++ template library for linear algebra
• elixir: Functional metaprogramming aware language built on Erlang VM
• entr: Run arbitrary commands when files change
• erlang: Programming language for highly scalable real-time systems
• exa: Modern replacement for 'ls'
• exiftool: Perl lib for reading and writing EXIF metadata
• fastlane: Easiest way to build and release mobile apps
• fd: Simple, fast and user-friendly alternative to find
• ffmpeg: Play, record, convert, and stream audio and video
• fpp: CLI program that accepts piped input and presents files for selection
• fzf: Command-line fuzzy finder written in Go
• gawk: GNU awk utility
• gdal: Geospatial Data Abstraction Library
• geos: Geometry Engine
• git: Distributed revision control system
• git-delta: A viewer for git and diff output
• git-lfs: Git extension for versioning large files
• git-madge: Git-aware madge wrapper
• glances: Alternative to top/htop
• glew: OpenGL Extension Wrangler Library
• glfw: Multi-platform library for OpenGL applications
• glslviewer: Live-coding console tool that renders GLSL Shaders
• gmp: GNU multiple precision arithmetic library
• gnupg: GNU Pretty Good Privacy (PGP) package
• go: Open source programming language to build simple/reliable/efficient software
• gotop: A terminal based graphical activity monitor inspired by gtop and vtop
• gource: Version Control Visualization Tool
• gradle: Open-source build automation tool based on the Groovy and Kotlin DSL
• graphicsmagick: Image processing tools collection
• graphviz: Graph visualization software from AT&T and Bell Labs
• grip: GitHub Markdown previewer
• gsettings-desktop-schemas: GSettings schemas for desktop components
• gtk+3: Toolkit for creating graphical user interfaces
• hexyl: Command-line hex viewer
• highlight: Convert source code to formatted text with syntax highlighting
• html-xml-utils: Tools for manipulating HTML and XML files
• httpie: User-friendly cURL replacement (command-line HTTP client)
• hub: Add GitHub support to git on the command-line
• ideviceinstaller: Tool for managing apps on iOS devices
• imagemagick: Tools and libraries to manipulate images in many formats
• infer: Static analyzer for Java, C, C++, and Objective-C
• ios-deploy: Install and debug iPhone apps from the command-line
• ios-webkit-debug-proxy: DevTools proxy for iOS devices
• irssi: Modular IRC client
• jpeg: Image manipulation library
• jq: Lightweight and flexible command-line JSON processor
• ktlint: Kotlin linter
• kubernetes-cli: Kubernetes command-line interface
• lame: High quality MPEG Audio Layer III (MP3) encoder
• libimobiledevice: Library to communicate with iOS devices natively
• libomp: LLVM's OpenMP runtime library
• libpq: Postgres C API library
• libxml2: GNOME XML library
• libyaml: YAML Parser
• lynx: Text-based web browser
• macvim: GUI for vim, made for macOS
• mas: Mac App Store command-line interface
• mdcat: Show markdown documents on text terminals
• navi: Interactive cheatsheet tool for the command-line.
• neovim: Ambitious Vim-fork focused on extensibility and agility
• ninja: Small build system for use with gyp or CMake
• nvm: Manage multiple Node.js versions
• opencv: Open source computer vision library
• pass: Password manager
• peco: Simplistic interactive filtering tool
• pidcat: Colored logcat script to show entries only for specified app
• pigz: Parallel gzip
• pkg-config: Manage compile and link flags for libraries
• postgresql: Object-relational database system
• protobuf: Protocol buffers (Google's data interchange format)
• pv: Monitor data's progress through a pipe
• pyenv: Python version management
• pyenv-virtualenv: Pyenv plugin to manage virtualenv
• python@2: Interpreted, interactive, object-oriented programming language
• q: Run SQL directly on CSV or TSV files
• qt: Cross-platform application and UI framework
• r: Software environment for statistical computing
• ranger: File browser
• rbenv: Ruby version manager
• rclone: Rsync for cloud storage
• reattach-to-user-namespace: Reattach process (e.g., tmux) to background
• rename: Perl-powered file rename script with many helpful built-ins
• restic: Fast, efficient and secure backup program
• ripgrep: Search tool like grep and The Silver Searcher
• rtv: Command-line Reddit client
• ruby: Powerful, clean, object-oriented scripting language
• rust: Safe, concurrent, practical language
• sourcekitten: Framework and command-line tool for interacting with SourceKit
• starship: Cross-shell prompt for astronauts
• swift-protobuf: Plugin and runtime library for using protobuf with Swift
• swiftlint: Tool to enforce Swift style and conventions
• task: Feature-rich console based todo list manager
• tasksh: Shell wrapper for Taskwarrior commands
• the_silver_searcher: Code-search similar to ack
• thefuck: Programmatically correct mistyped console commands
• tig: Text interface for Git repositories
• tmux: Terminal multiplexer
• tree: Display directories as trees (with optional color/HTML output)
• vim: Vi 'workalike' with many additional features
• visidata: Terminal utility for exploring and arranging tabular data
• vtk: Toolkit for 3D computer graphics, image processing, and visualization
• watchman: Watch files and take action when they change
• wget: Internet file retriever
• x264: H.264/AVC encoder
• xdot: Interactive viewer for graphs written in Graphviz's dot language
• xvid: High-performance, high-quality MPEG-4 video library
• xz: General-purpose data compression with high compression ratio
• yabai: A tiling window manager for macOS based on binary space partitioning.
• yq: Process YAML documents from the CLI
• yvm: Manage multiple versions of Yarn
• zlib: General-purpose lossless data-compression library
• zplug: Next-generation plugin manager for zsh
• zsh: UNIX shell (command interpreter)
• zsh-autosuggestions: Fish-like fast/unobtrusive autosuggestions for zsh
• zsh-syntax-highlighting: Fish shell like syntax highlighting for zsh
• zstd: Zstandard is a real-time compression algorithm