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.
 
 
 
resh/README.md

77 lines
2.1 KiB

![GitHub tag (latest SemVer)](https://img.shields.io/github/v/tag/curusarn/resh?sort=semver)
![Go test](https://github.com/curusarn/resh/actions/workflows/go.yaml/badge.svg)
![Shell test](https://github.com/curusarn/resh/actions/workflows/sh.yaml/badge.svg)
# Rich Enhanced Shell History
Context-based replacement/enhancement for zsh and bash shell history
<!-- Contextual shell history -->
<!-- Contextual bash history -->
<!-- Contextual zsh history -->
<!-- Context-based shell history -->
<!-- Context-based bash history -->
<!-- Context-based zsh history -->
<!-- Better shell history -->
<!-- Better bash history -->
<!-- Better zsh history -->
<!-- PWD Directory -->
**Search your history by commands or arguments and get relevant results based on current directory, git repo, exit status, and device.**
## Install with one command
```sh
curl -fsSL https://raw.githubusercontent.com/curusarn/resh/master/scripts/rawinstall.sh | sh
```
You will need to have `curl` and `tar` installed.
More options on [Installation page](./installation.md)
## Update
Once installed RESH can be updated using:
```sh
reshctl update
```
## Search your history
TODO: redo this
Draft:
See RESH in action - record a terminal video
Recording content:
Search your history by commands - Show searching some longer command
Get results based on current context - Show getting project-specific commands
Find any command - Show searching where the context brings the relevant command to the top
Start searching now - Show search in native shell histories
Press CTRL+R to search.
Say bye to weak standard history search.
TODO: This doesn't seem like the right place for keybindings
### In-app key bindings
- Type to search/filter
- Up/Down or Ctrl+P/Ctrl+N to select results
- Right to paste selected command onto the command line so you can edit it before execution
- Enter to execute
- Ctrl+C/Ctrl+D to quit
- Ctrl+G to abort and paste the current query onto the command line
- Ctrl+R to switch between RAW and NORMAL mode
## Issues & Ideas
Find help on [Troubleshooting page](./troubleshooting.md)
Still got an issue? Create an issue: https://github.com/curusarn/resh/issues