Package: xxh-xxh
You stuffed command shell with aliases, tools and colors but you lose it all when using ssh. The mission of xxh is to bring your favorite shell wherever you go through ssh without root access and system installations.If you like the idea of xxh click ⭐ on the repo andtweet.Portable. Preparing portable shells and plugins occurs locally and then xxh uploads the result to the host. No installations or root access on the host required. Security and host environment a prime focus.Hermetic. Deleting~/.xxhdirectory from the remote host will make the remote environment function as if xxh was never there. By default your home is the.xxhdirectory and you canchoose the hermetic level of your xxh session.Careful. No blindfold copying config files from local to remote host. Following privacy and repeatability practices the best way is to fork the xxh plugin or shell example and pack your configs into it.Be open and fork-ready. Every xxh repo could be forked, customized and reused without waiting for a package management system, xxh release or any third party packages. Five shells are currently supported and more could be added by the community.Do more. The xxh packages are not only about shells. Any type of tool or code could be behind an entrypoint. If you want to runbrowshon the remote host, just put its portable version as an entrypoint in the xxh-shell.Chameleon. Switching the shells is as easy as possible and you don't have to be locked in to one shell. Choose your current shell based on the task you want to solve:xxh anyhost +s xonshfor a python environment, osquery for simple querying, fish for modern features or time-tested zsh and bash for speed.Installation methodsPyPi 3pip3installxxh-xxhpipx- good alternative to brew and pip, readcomparisonpipxinstallxxh-xxhConda-forgefeedstockcondaconfig--addchannelsconda-forge
condainstallxxh-xxhHomebrewbrewinstallxxhMacportssudoportinstallxxhLinux portable binarymkdir~/xxh&&cd~/xxh
wgethttps://github.com/xxh/xxh/releases/download/0.8.7/xxh-portable-musl-alpine-Linux-x86_64.tar.gz
tar-xzfxxh-portable-musl-alpine-Linux-x86_64.tar.gz
./xxhLinuxAppImagemkdir~/xxh&&cd~/xxh
wget-Oxxhhttps://github.com/xxh/xxh/releases/download/0.8.7/xxh-x86_64.AppImage
chmod+xxxh&&./xxhTo run AppImage on Alpine Linuxinstallalpine-pkg-glibcwithlocaledef.ShellsCurrently supported OS for target host is Linux on x86_64.xxh-shellstatusxxh-pluginsseamlessdemoxonshstableautojump,[+]xxh.xshdemozshstableohmyzsh,p10k,[+]xxh.zshdemofishstableohmyfish,fisher,userconfig,[+]todobashstableohmybash,[+]xxh.bashdemoosquerybetafish-appimagealphaelvishalphaSearch xxh shell on GithuborBitbucketorcreate your shell entrypointto use another portable shell.Prerun pluginsPrerun pluginsallow you to bring any portable tools, dotfiles or aliases to xxh session before running shell.Pinned plugins:core(xxh-sudo, xxh-screen, xxh-tmux),dotfiles,docker,python,xxh,vim,zoxide,starship. There iscookiecutter template to create prerun plugin.UsageUsexxhinstead ofsshwhen connecting to Linux hosts without changing ssh arguments:xxh <host from ~/.ssh/config>
xxh [ssh arguments] [user@]host[:port] [xxh arguments]
xxh local [xxh arguments]Common examples (usexxh --helpto get info about arguments):xxh anyhost# Connect to the hostxxh -i id_rsa -p 2222 anyhost# Using ssh arguments: port and keyxxh user@host +c et# Using EternalTerminal (https://github.com/MisterTea/EternalTerminal)xxh anyhost +s zsh +i# Set the shell and install it without yes/no questionxxh anyhost +s xonsh +hhh "~"# Set /home/user as home directory (read Q&A)xxh anyhost +s bash +I xxh-plugin-bash-vim# Preinstall a pluginxxh anyhost +if +q# Force reinstall xxh on the host in quiet modexxh anyhost +hh /tmp/xxh +hhr# Upload xxh to /tmp/xxh and remove when disconnectingsource xxh.zsh anyhost +I xxh-plugin-zsh-ohmyzsh# Connect in seamless mode with ohmyzsh pluginxxh local +s xonsh# Experimental: build xxh environment inplace and without sshFor reusing arguments and simplifying xxh usage (like shortening toxxh anyhost) there is aconfig file.Why the plus sign for the xxh arguments?The xxh is using the plus sign for the xxh arguments to save the ability to use the minus sign for the original ssh arguments. This allows just replace the first two letters in thesshcommand to convert it to thexxhcommand. Also see thediscussion.Installing xxh packagesxxh[+Ixxh-package+I...][+L][+RIxxh-package+RI...][+Rxxh-package+R...]Different ways to set the xxh package source:xxh +I xxh-shell-example# install from https://github.com/xxhxxh +I https://github.com/xxh/xxh-shell-example# short url for github only, for other sources use examples below or add supportxxh +I https://github.com/xxh/xxh-shell-example/tree/mybranch# short url for github only, for other sources use examples below or add supportxxh +I xxh-shell-example+git+https://github.com/xxh/xxh-shell-example# long url for any git repoxxh +I xxh-shell-example+git+https://github.com/xxh/xxh-shell-example/tree/mybranch# github only branch supportxxh +I xxh-shell-example+git+git@github.com:githubuser/xxh-shell-example.git# install from private repository using sshxxh +I xxh-shell-example+path+/home/user/my-xxh-dev/xxh-shell-example# install from local pathUsing xxh inplace without ssh connectionThis is experimental magic. Please read the text below twice.If you have shell access on the host or you're in a docker container and you can't ssh to it
then you can download and build hermetic xxh environment inplace. Thexxh localcommand works
exactly likexxh remote_hostand creates a hermetic environment in~/.xxhby default.At this time we don't have portable build tools likegit,wget,curl,tarand others which
could be required by some xxh package build scripts. When runningxxh localit is expected that the tools are present on the host.To run xxh inplace on Linux x86_64 just copy and paste these bash commands:XH=~/.xxh\&&XD=https://github.com/xxh/xxh-portable/raw/master/result/xxh-portable-musl-alpine-Linux-x86_64.tar.gz\&&mkdir-p$XH&&cd$XH\&&([[-x$(command-vcurl)]]&&curl-L$XD||wget-O-$XD)|tarzxf-xxh\&&echo'Usage: ./xxh local [+s xonsh/zsh/fish/osquery/bash]'Next time you're on host just run~/.xxh/xxh localand you will enter your xxh environment.Examples of use casesPython with pip everywhere without installationWay 1. Using xonshxxh anyhost +s xonsh

anyhost> python --version
Python 3.8.2You'll get python-poweredxonshshell with portable python and pip on the host without any system installations on the host.
You can install PyPi packages manually or bring them with you automatically by usingxxh-plugin-prerun-dotfiles. Also don't forget about xxh-plugins likezoxide.Way 2. Using portable python on any xxh shellxxh +RI xxh-plugin-prerun-python
xxh anyhost +s zsh

anyhost> python --version
Python 3.8.2
anyhost> pip install pandasUsingxxh-plugin-prerun-pythonyou'll get a portable
Python AppImage which can be used on a host without python and with any xxh shell.Using docker on host without root accessTryxxh-plugin-prerun-docker:xxh +RI xxh-plugin-prerun-docker
xxh anyhost +if

anyhost> xxh-docker-run
anyhost> docker ps                                                                                                                                                                                                                            
CONTAINER ID        IMAGE               COMMAND
anyhost> docker run --rm hello-world | grep Hello
Hello from Docker!
anyhost> xxh-docker-stopBring dotfiles to xxh sessionThere is thexxh-plugin-prerun-dotfilesplugin which creates config files
when you go to the host using xxh. You can fork it and create your cozy settings once and forever.Seamless Oh My Zsh (demo)sourcexxh.zshanyhost+Ixxh-plugin-zsh-ohmyzsh+if+qThis command brings your current Oh My Zsh session theme to the xxh session. If you need more complex settings just fork
thexxh-plugin-zsh-ohmyzshand hack it.Read host as a table withosquery$ xxh anyhost +s osquery
osquery> SELECT * FROM users WHERE username='news';
+-----+-----+----------+-------------+-----------------+-------------------+
| uid | gid | username | description | directory       | shell             |
+-----+-----+----------+-------------+-----------------+-------------------+
| 9   | 9   | news     | news        | /var/spool/news | /usr/sbin/nologin |
+-----+-----+----------+-------------+-----------------+-------------------+All in one portable homexxh is very agile. You can create your ownxxh-shell(the shell part means it has an entrypoint) which can have any portable tools
that could help you on the host.Bashxxh-shell is one of these
platforms that could be forked and stuffed.Questions and answersWelcome to xxh familyHow it worksSimple answerDetailed workflow with codePluginsConnection speedSeamless modeConfig filePackages for xxhInstall shells and pluginsAdvancedHow to set /home/user as home on hostUsing sudoUsing xxh in xxh sessionTarget host is behind another hostEnvironment variablesDevelopment and contributionThe easiest way to debug shell and pluginsPrerun pluginsChange plugin run orderNew questionsDevelopmentxxh Development EnvironmentIn thexxh development environmentthere is fulldockerisedenvironment
for development, testing and contribution. The process of testing and development is orchestrated byxdetool and is as
easy as possible.Vagrant based Plugin DevelopmentTo develop plugins,Vagrantsupports startingmany configurationsof virtual machines using Virtualbox.Seethe Plugin Development folderfor more detailsWe have teamsIf you're in a team it does not mean you have an obligation to do something. The main goal of teams is to create groups
of passionate people who could help or support solving complex problems. Some people could be an expert in one shell and a
newbie in another shell and mutual assistance is the key to xxh evolution.Ask join.Thanksniessfor greatpython-appimageprobonopdandTheAssassinfor hard-workingAppImageAnthony Scopatz,Gil Forsyth,Jamie Bliss,David Strobach,Morten Enemark Lundand@xorefor amazingxonsh shellRoman Perepelitsafor incrediblestatically-linked, hermetic, relocatable ZshJohannes AltmanningerandFabian Homborgfor extensive and portablefish shell