2025-03-14 21:59:59 -06:00
# xxh
> Bring your shell with all of your customizations through SSH sessions.
2025-05-08 12:26:01 -06:00
> Note: `xxh` does not install anything into system directories on the target machine; removing `~/.xxh` will clear all traces of xxh on the target machine.
> More information: <https://github.com/xxh/xxh#usage>.
2025-03-14 21:59:59 -06:00
- Connect to a host and run the current shell:
`xxh "{{host}}"`
- Install the current shell into the target machine without prompting:
`xxh "{{host}}" ++install`
- Run the specified shell on the target machine:
`xxh "{{host}}" ++shell {{xonsh|zsh|fish|bash|osquery}}`
- Use a specific xxh configuration directory on the target machine:
`xxh "{{host}}" ++host-xxh-home {{~/.xxh}}`
- Use the specified configuration file on the host machine:
`xxh "{{host}}" ++xxh-config {{~/.config/xxh/config.xxhc}}`
- Specify a password to use for the SSH connection:
`xxh "{{host}}" ++password "{{password}}"`
- Install an xxh package on the target machine:
`xxh "{{host}}" ++install-xxh-packages {{package}}`
- Set an environment variable for the shell process on the target machine:
`xxh "{{host}}" ++env {{name}}={{value}}`
