Warning

This script WILL clobber existing configuration files for the above applications. Read the script and backup files before running if needed.

Just run ./deploy.sh

Configurations will be deployed to standard locations for a *nix/Mac user directory by force creating a symlink back to this repository's files.

Additions

Configurations and their destinations are listed in the deploy script's associative array (dict) named configs. Additions or alterations to locations or new configs are to be added there.

Note

The wezterm's local configuration file is not currently activated in the configs dict. It is meant as a local configuration file and is set up to handle some linux specific configuration settings that may not be applicable. Add this alongside the wezterm.lua config (uncommenting in the deploy script) and it will be automatically loaded by the main wezterm.lua config.

Updating

git pull will give the latest changes and via symlinks they will immediately be available to the appropriate applications.

Applications

Neovim

Console/terminal based text editor with hefty extensibility, speed and flexibility.

The configs are an attempt at including some IDE functionalities

Auto-complete via nvim-cmp
LSP setup via lspconfig and mason
Debugging via DAP and plugins
Code snippets via luasnips and a base
Git integration via gitsigns
Syntax highlighting and symbol parsing via treesitter
Quality of life options
- Language aware shortcuts for (un)commenting lines or blocks
- Zettlekasten style note plugin for taking/searching/linking notes
- Markdown preview that opens a live updating html view of an edited markdown file
- Telescope fuzzy search for files and file contents

Tmux

The terminal multiplexer for windowing and pane setups for long running shell sessions.

Simple configuration setup for a few shortcuts, adding the tpm plugin manager, and adding a couple plugins for colorscheme, system clipboard interactions and a few "sensible" settings.

The main changes to shortcuts involve:

Moving to Ctrl-Space for the prefix leader instead of the default Ctrl-b
Using \ and - for splitting the window vertically and horizontally, respectively, and unbinding the defaults
Adding a config reload shortcut of <prefix> r
Moving to vim-like movement between panes and windows
Removing auto-renaming of windows based on content

Wezterm

Cross-platform terminal emulator built from the ground up with speed, good font rendering, true color and a host of nice optional functions.

Simple setup with automatic config reloading, a colorscheme, font and a couple other bits.

The wezterm.local_linux.lua file is meant as a template for creating a local configuration while also tracking generic linux xcursor configurations required to fix an issue with cursor display. To use it, copy the file to ~/.config/wezterm/local.lua and wezterm should reload configs automatically.

Zsh

NOTE: Auto-installs oh-my-zsh directly from the github repository when a user opens Zsh for the first time

Sets up the oh-my-zsh framework with:

Colorscheme
Autosuggestions and virtual text
Prompt theme
Python virtualenv auto-loader
.env auto-loader
AWS helper
Git helper and prompt updater

The config adds the following settings outside of oh-my-zsh:

PATH environment variable additions for:
- Go binaries
- Rust binaries
- User $HOME based .local/bin
- NVM (Nodejs) binaries
Keychain initialization for caching SSH keys
Adding a timing function for checking ZSH load timing
NVM (Nodejs) environment variable setup and completion loading
Local specific configuration file loading, with three initial configs:
- .zsh_aliases: Aliases for local specific commands
- .zsh_exports: Exported variables for a specific system
- .zsh_local: Local ZSH settings for a specific system such as any environment specific bash required to set up a system's shell or direct ZSH settings