README.md

My ZSH Custom for local/SSH users

I develop often on remote servers that I don't have sudo permission. This awesome zsh settings allow you to install locally, without root permission.

ZSH Basics (Getting Started)

• Oh My Zsh: Manage zsh configuration. Includes many small plugins.

  • git: aliases for many git commands.
  • dirhistory: Alt+Left/Right to navigate directory history. Alt+Up to go to the parent directory.
  • It will source all files in custom/ directory.

• Starship: Prompt (theme) that shows project statuses (git, conda, python version, etc.)

• Some commands are aliased (e.g., ls -> eza, cat -> bat, vi -> nvim).

  • When you want to use the original command, add \ prefix (e.g. \ls, \cat).

Setup

Install zsh locally. (🚨 warning: sudo apt install zsh may install an old version. Use the script below.)

bash -c "$(curl -fsSL https://raw.github.com/kiyoon/dotfiles/master/oh-my-zsh/zsh-local-install.sh)"

Add the lines below to your ~/.bashrc (if you don't have root permission and can't do chsh):

export PATH="$HOME/.local/bin:$PATH"
if [[ ($- == *i*) ]];
then
    export SHELL=$(which zsh)
    exec zsh -l
fi

Install oh-my-zsh:

sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Install / update plugins:

git submodule update --init --remote

Install apps:

##### tig, exa, gh, starship, ..
bash apps-local-install.sh

(Optional) Additional settings:

##### git
git config --global user.email "kiyoon@users.noreply.github.com"
git config --global user.name "Kiyoon Kim"
git config --global core.editor nvim
git config --global pull.rebase false
git config --global url.ssh://git@github.com/.insteadOf https://github.com/

gh auth login
gh alias set r repo

(Optional) Apps when you have root permission:

sudo apt update -y
sudo apt install -y xclip

Copy .zshrc to $HOME.