Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/grrlopes/storydb
A bash/zsh ctrl+r improved command history finder.
https://github.com/grrlopes/storydb
bash command command-line-tool history tui zsh zsh-plugin
Last synced: 2 months ago
JSON representation
A bash/zsh ctrl+r improved command history finder.
- Host: GitHub
- URL: https://github.com/grrlopes/storydb
- Owner: grrlopes
- License: mit
- Created: 2023-05-22T05:36:37.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-01-11T06:07:03.000Z (11 months ago)
- Last Synced: 2024-09-28T08:21:04.299Z (3 months ago)
- Topics: bash, command, command-line-tool, history, tui, zsh, zsh-plugin
- Language: Go
- Homepage:
- Size: 1.68 MB
- Stars: 8
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- charm-in-the-wild - Storydb - An improved bash/zsh-style ctrl+r command history finder. (_built with Bubble Tea_) (Applications / Development Tools)
README
# 🚀 - Vault cmd-line terminal app
- That project can read bash/zsh history or might any plain text file content and store it into SQLite, Which offers a convenient and effective method for organizing and retrieving command-line typed.
- The convenience of TUI empowers you to browse and search your 'history' using simple key strokes, enhancing the convenience of accessing and scrutinizing your previous commands.
## Installation
- Download the binary through [Latest version](https://github.com/grrlopes/storydb/releases) and place storydb into ```/bin``` or Clone the project and run ```go run build```
- You can overwrite your currently crt+r by ```bind '"\C-r": "\C-a storydb \C-j"'``` put it in your global variable as ```/etc/profile``` or ```$HOME/profile```
- Running ```sysctl -w dev.tty.legacy_tiocsti=1``` if your kernel is 6.2 or above.
There is a reason why kernel devs disabled it. [Reason](https://cateee.net/lkddb/web-lkddb/LEGACY_TIOCSTI.html)
You can conveniently explore and interact with your command-line history, making it easier to recall past commands, analyze usage patterns, and improve your workflow in the terminal.
## ⌨️ Button Mapping
| Key | Event |
|-----------------|---------------------------|
| k, shift+tab, ↑ | up |
| ctrl+d, → | page right |
| j, ↓ | down |
| ctrl+s, ← | page left |
| enter | select row to fill term |
| ctrl+c, q | bring down finder or quit |
| alt+s | sync/load history file |
| ctrl+r | reset finder text input |
| f | bring up finder text input|
## Set up
- You must set up ```export storydb=$(tty)``` in your global variable profile that is usually located at /etc/profile or $HOME
- Your bash/zsh history file should be set up as ``` export HISTFILE=$HOME/.bash_history``` or ```export HISTFILE=$HOME/.zsh_history```
## Requirements
- Go 1.20+