mirror of https://github.com/curusarn/resh
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
71 lines
1.7 KiB
71 lines
1.7 KiB
# Installation
|
|
|
|
## One command installation
|
|
|
|
Feel free to check the `rawinstall.sh` script before running it.
|
|
|
|
```sh
|
|
curl -fsSL https://raw.githubusercontent.com/curusarn/resh/master/scripts/rawinstall.sh | sh
|
|
```
|
|
|
|
You will need to have `curl` and `tar` installed.
|
|
|
|
## Clone & Install
|
|
|
|
```sh
|
|
git clone https://github.com/curusarn/resh.git
|
|
cd resh
|
|
scripts/rawinstall.sh
|
|
```
|
|
|
|
## Build from source
|
|
|
|
:warning: Building from source is intended for development and troubleshooting.
|
|
|
|
```sh
|
|
git clone https://github.com/curusarn/resh.git
|
|
cd resh
|
|
make install
|
|
```
|
|
|
|
## Update
|
|
|
|
Once installed RESH can be updated using:
|
|
```sh
|
|
reshctl update
|
|
```
|
|
|
|
## Disabling RESH
|
|
|
|
If you have a persistent issue with RESH you can temporarily disable it and then enable it later.
|
|
You won't lose your history nor configuration.
|
|
|
|
Go to `~/.zshrc` and `~/.bashrc` and comment out following lines:
|
|
```sh
|
|
[[ -f ~/.resh/shellrc ]] && source ~/.resh/shellrc
|
|
[[ -f ~/.bash-preexec.sh ]] && source ~/.bash-preexec.sh # bashrc only
|
|
```
|
|
The second line is bash-specific so you won't find it in `~/.zshrc`
|
|
|
|
You can re-enable RESH by uncommenting the lines above or by re-installing it.
|
|
|
|
## Uninstallation
|
|
|
|
You can uninstall RESH by running: `rm -rf ~/.resh/`.
|
|
Restart all open terminals after uninstall!
|
|
|
|
### Installed files
|
|
|
|
Binaries and shell files are in: `~/.resh/`
|
|
|
|
Recorded history, device files, and logs are in one of:
|
|
- `~/.local/share/resh/`
|
|
- `${XDG_DATA_HOME}/resh/`
|
|
|
|
RESH config file is in: `~/.config/resh.toml`
|
|
|
|
RESH also adds a following lines to `~/.zshrc` and `~/.bashrc` to load itself on terminal startup:
|
|
```sh
|
|
[[ -f ~/.resh/shellrc ]] && source ~/.resh/shellrc
|
|
[[ -f ~/.bash-preexec.sh ]] && source ~/.bash-preexec.sh # bashrc only
|
|
```
|
|
|