https://github.com/tymm/zsh-directory-history

Giving you a history which is sensitive to the directory you are currently in
https://github.com/tymm/zsh-directory-history

Last synced: about 2 months ago
JSON representation

Giving you a history which is sensitive to the directory you are currently in

• Host: GitHub
• URL: https://github.com/tymm/zsh-directory-history
• Owner: tymm
• Created: 2014-03-14T14:20:31.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2020-01-31T16:14:34.000Z (over 4 years ago)
• Last Synced: 2024-03-12T22:47:18.815Z (3 months ago)
• Language: Shell
• Homepage:
• Size: 42 KB
• Stars: 154
• Watchers: 7
• Forks: 13
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md

Lists

• awesome-zsh-plugins - directory-history - A per directory history for ZSH which implements forward/backward navigation as well as substring search in a directory sensitive manner. (Plugins / ZSH on Windows)
• fucking-awesome-zsh-plugins - directory-history - A per directory history for ZSH which implements forward/backward navigation as well as substring search in a directory sensitive manner. (Plugins / ZSH on Windows)
• fucking-awesome-zsh-plugins - directory-history - A per directory history for ZSH which implements forward/backward navigation as well as substring search in a directory sensitive manner. (Plugins / ZSH on Windows)
• awesome-zsh-plugins - directory-history - A per directory history for ZSH which implements forward/backward navigation as well as substring search in a directory sensitive manner. (Plugins / ZSH on Windows)
• awesome-zsh-plugins - directory-history - A per directory history for ZSH which implements forward/backward navigation as well as substring search in a directory sensitive manner. (Plugins / Zinit (née zplugin))

README

        
zsh-directory-history

=================

A per directory history for zsh.

DESCRIPTION

-----------

zsh-directory-history is a zsh plugin giving you a history which is sensitive to the directory you are in.  

It implements forward/backward navigation as well as substring search in a directory sensitive manner.  

Since zsh-directory-history includes [zsh-history-substring-search](https://github.com/zsh-users/zsh-history-substring-search), do not load zsh-history-substring-search when loading this plugin.

Behavior:  

* Commands executed in the current directory will pop up first when navigating the history or using substring search.  

* A substring unknown in the current directory, will be searched for globally (it falls back to the normal substring search behavior).

Since the plugin creates its own history (in `~/.directory_history`), it needs some time to fill up and become useful.

INSTALL

-------

1. Install script

         git clone https://github.com/tymm/zsh-directory-history

         sudo cp zsh-directory-history/dirhist /usr/bin/

2. Activate plugin by appending the following line to your _.zshrc_ file

         source /path/to/directory-history.plugin.zsh

3. Bind keyboard shortcuts in your _.zshrc_  

`directory-history-search-forward`/`directory-history-search-backward` needs to be bind for forward/backward navigation.  

`history-substring-search-up`/`history-substring-search-down` needs to be bind for substring search.  

For example:

         # Bind up/down arrow keys to navigate through your history

         bindkey '\e[A' directory-history-search-backward

         bindkey '\e[B' directory-history-search-forward

         # Bind CTRL+k and CTRL+j to substring search

         bindkey '^j' history-substring-search-up

         bindkey '^k' history-substring-search-down

It is possible that \e[A and \e[B will not work for you.

Look [here](https://github.com/zsh-users/zsh-history-substring-search) under 2. for more information.

For more information on how to configure substring search, take a look here: https://github.com/zsh-users/zsh-history-substring-search