From c95183d2c5471af0e58769be9661523a7d85ca2e Mon Sep 17 00:00:00 2001 From: David Dworken Date: Thu, 21 Dec 2023 18:50:57 -0800 Subject: [PATCH] Add blockquote tag to make zippys look prettier in README --- README.md | 56 +++++++++++++++++++++++++++---------------------------- 1 file changed, 28 insertions(+), 28 deletions(-) diff --git a/README.md b/README.md index 615c5c8..1c64741 100644 --- a/README.md +++ b/README.md @@ -60,7 +60,7 @@ To update `hishtory` to the latest version, just run `hishtory update` to secure ### Advanced Features
-AI Shell Assistance +AI Shell Assistance
If you are ever trying to figure out a bash command and searching your history isn't working, you can query ChatGPT by prefixing your query with `?`. For example, press `Control+R` and then type in `? list all files larger than 1MB`: ![demo showing ChatGPT suggesting the right command](https://raw.githubusercontent.com/ddworken/hishtory/master/backend/web/landing/www/img/aidemo.png) @@ -69,10 +69,10 @@ If you would like to: * Disable this, you can run `hishtory config-set ai-completion false` * Run this with your own OpenAI API key (thereby ensuring that your queries do not pass through the centrally hosted hiSHtory server), you can run `export OPENAI_API_KEY='...'` -
+
-TUI key bindings +TUI key bindings
The TUI (opened via `Control+R`) supports a number of key bindings: | Key | Result | @@ -85,10 +85,10 @@ The TUI (opened via `Control+R`) supports a number of key bindings: Press `Control+H` to view a help page documenting these. -
+
-Changing the displayed columns +Changing the displayed columns
You can customize the columns that are displayed via `hishtory config-set displayed-columns`. For example, to display only the cwd and command: @@ -98,10 +98,10 @@ hishtory config-set displayed-columns CWD Command The list of supported columns are: `Hostname`, `CWD`, `Timestamp`, `Runtime`, `ExitCode`, `Command`, and `User`. -
+
-Custom Columns +Custom Columns
You can create custom column definitions that are populated from arbitrary commands. For example, if you want to create a new column named `git_remote` that contains the git remote if the cwd is in a git directory, you can run: @@ -110,24 +110,24 @@ hishtory config-add custom-columns git_remote '(git remote -v 2>/dev/null | grep hishtory config-add displayed-columns git_remote ``` -
+
-Custom Color Scheme +Custom Color Scheme
You can customize hishtory's color scheme for the TUI. Run `hishtory config-set color-scheme` to see information on what is customizable and how to do so. -
+
-Disabling Control+R integration +Disabling Control+R integration
If you'd like to disable the Control+R integration in your shell, you can do so by running `hishtory config-set enable-control-r false`. If you do this, you can then manually query hiSHtory by running `hishtory query `. -
+
-Filtering duplicate entries +Filtering duplicate entries
By default, hishtory query will show all results even if this includes duplicate history entries. This helps you keep track of how many times you've run a command and in what contexts. If you'd rather disable this so that hiSHtory won't show duplicate entries, you can run: @@ -135,19 +135,19 @@ By default, hishtory query will show all results even if this includes duplicate hishtory config-set filter-duplicate-commands true ``` -
+
-Offline Install Without Syncing +Offline Install Without Syncing
If you don't need the ability to sync your shell history, you can install hiSHtory in offline mode. Download the latest binary from [Github Releases](https://github.com/ddworken/hishtory/releases), and then run `./hishtory-binary install --offline` to install hiSHtory in a fully offline mode. This disables syncing and it is not possible to re-enable syncing after doing this. -
+
-Self-Hosting +Self-Hosting
By default, hiSHtory relies on a backend for syncing. All data is end-to-end encrypted, so the backend can't view your history. @@ -162,44 +162,44 @@ A few configuration options: * If you want to use a SQLite backend, you can do so by setting the `HISHTORY_SQLITE_DB` environment variable to point to a file. It will then create a SQLite DB at the given location. * If you want to limit the number of users that your server allows (e.g. because you only intend to use the server for yourself), you can set the environment variable `HISHTORY_MAX_NUM_USERS=1` (or to whatever value you wish for the limit to be). Leave it unset to allow registrations with no cap. -
+
-Importing existing history +Importing existing history
hiSHtory imports your existing shell history by default. If for some reason this didn't work (e.g. you had your shell history in a non-standard file), you can import it by piping it into `hishtory import` (e.g. `cat ~/.my_history | hishtory import`). -
+
-Custom timestamp formats +Custom timestamp formats
You can configure a custom timestamp format for hiSHtory via `hishtory config-set timestamp-format '2006/Jan/2 15:04'`. The timestamp format string should be in [the format used by Go's `time.Format(...)`](https://pkg.go.dev/time#Time.Format). -
+
-Customizing the install folder +Customizing the install folder
By default, hiSHtory is installed in `~/.hishtory/`. If you want to customize this, you can do so by setting the `HISHTORY_PATH` environment variable to a path relative to your home directory (e.g. `export HISHTORY_PATH=.config/hishtory`). This must be set both when you install hiSHtory and when you use hiSHtory, so it is recommend to set it in your `.bashrc`/`.zshrc`/`.fishrc` before installing hiSHtory. -
+
-Viewing debug logs +Viewing debug logs
Debug logs are stored in `~/.hishtory/hishtory.log`. If you run into any issues, these may contain useful information. -
+
-Uninstalling +Uninstalling
If you'd like to uninstall hishtory, just run `hishtory uninstall`. Note that this deletes the SQLite DB storing your history, so consider running a `hishtory export` first. Note that if you're experiencing any issues with hiSHtory, try running `hishtory update` first! Performance and reliability is always improving, and we highly value [your feedback](https://github.com/ddworken/hishtory/issues). -
+ ## Design