Mirror
/
resh
mirror of https://github.com/curusarn/resh
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Rich Enhanced Shell History - Contextual shell history for zsh and bash
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.
540 Commits
2 Branches
102 Tags
3.1 MiB
 
 
 
Tag: Branch: Tree: 7d29349562
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '7d29349562'
${ noResults }
resh/troubleshooting.md

1.5 KiB
Raw Blame History Escape

Troubleshooting

First help

Run RESH doctor to detect common issues:

reshctl doctor

Restarting RESH daemon

Sometimes restarting RESH daemon can help:

resh-daemon-restart

You can also start and stop RESH daemon with:

resh-daemon-start
resh-daemon-stop

⚠️ You will get error messages in your shell when RESH daemon is not running.

Recorded history

Your RESH history is saved in one of:

  • ~/.local/share/resh/history.reshjson
  • $XDG_DATA_HOME/resh/history.reshjson

The format is JSON prefixed by version. Display it as json using:

cat ~/.local/share/resh/history.reshjson | sed 's/^v[^{]*{/{/' | jq .

You will need jq installed.

Configuration

RESH config is read from one of:

  • ~/.config/resh.toml
  • $XDG_CONFIG_HOME/resh.toml

Logs

Logs can be useful for troubleshooting issues.

Find RESH logs in one of:

  • ~/.local/share//resh/log.json
  • $XDG_DATA_HOME/resh/log.json

Log verbosity

Get more detailed logs by setting LogLevel = "debug" in RESH config.
Restart RESH daemon for the config change to take effect: resh-daemon-restart

Common issues

Using RESH in bash on macOS

MacOS comes with really old bash (bash 3.2).
Update it using: brew install bash

On macOS, bash shell does not load ~/.bashrc because every shell runs as login shell.
Run echo '[ -f ~/.bashrc ] && . ~/.bashrc' >> ~/.bash_profile

Github issues

Problem persists? Create an issue ⇗