anyrc

Bring your .bashrc, .zshrc, .vimrc, etc. into any remote environments, such as ssh, docker container (docker exec/kubectl exec), and other user (su).

🔜 Usage

Just use *rc commands instead of original commands

• sshrc xxx instead of ssh xxx
  • e.g., sshrc -p 10022 [email protected]
• surc xxx instead of su xxx
  • e.g., surc foo
• dockrc xxx instead of docker exec xxx
  • e.g., dockrc foo_container bash
• kuberc xxx instead of kubectl exec xxx
  • e.g., kuberc foo_pod zsh

Setup

# Will be installed into /usr/local/bin
# DIR: Where to install
# FORCE: Override .anyrc or not
curl -sSL https://github.com/amaya382/anyrc/raw/master/install.sh | DIR=/usr/local/bin bash

# Put your dotfiles or create symlinks of them into $HOME/.anyrc.d
ln -s /path/to/your/dotfiles/.dotfile $HOME/.anyrc.d/.dotfile

Options

• ANYRC_DANYRC: Path to .anyrc. Default is in home dir or curr dir
• ANYRC_DANYRCD: Path to .anyrc.d. Default is in home dir or curr dir
• ANYRC_DOCKER_WO_TAR: If set, will work w/o tar on dockrc
• ANYRC_K8S_WO_TAR: If set, will work w/o tar on kuberc
• ANYRC_WO_TAR: If set, will work w/o tar on any remote environment

Customize

Config files

• .anyrc: Pre-configured for zsh, bash, tmux, and vim. If you want to support another tool, edit me.
• .anyrc.d/*: Dotfiles you want to bring into remote. Symlinks are allowed.

Environment variables (in .anyrc and .anyrc.d/*)

• ANYRC_ENV: Show remote environment (ssh/su/docker/k8s)
• ANYRC_ROOT: Path to tmp dir including all anyrc-related files each connection
• ANYRC_HOME: Path to dir for dotfiles
• ANYRC_DANYRC: Path to .anyrc
• ANYRC_DANYRCD: Path to .anyrc.d

Examples

See example

🔱 Features

Supported remote environments

• ssh
  • Attach w/ a login shell
• docker exec
  • Attach w/ a specified shell
• kubectl exec
  • Attach w/ a specified shell
• su (work w/ sudo)
  • Attach w/ a login shell

Supported tools

• zsh
• bash
• tmux
• vim
• etc.

🙇 Acknowledgement

• Russell91/sshrc
  • Using a lot of logics and codes from sshrc