zsh-deja-vu

"That feeling you've run this command here before?"

A Zsh plugin that logs and retrieves command history based on the directory it was run in. Never forget that complex docker or git command you ran in a project folder weeks ago.

Features

• Logs commands with their directory: Silently in the background.
• djvu: A command to show history for the current directory, just like history.
• djvu <path>: Lets you query the history for any directory.
• djvi: An interactive fuzzy finder (using fzf) to search your entire directory history.
• Automatic Keybinding: Binds Ctrl+F to the interactive search out of the box.

Installation

Prerequisites

• fzf: Required for the interactive search (djvi). Install fzf here.

For Zsh Plugin Managers (Oh My Zsh, etc.)

1. Clone this repository into your plugin manager's custom plugin directory.

   Oh My Zsh:

   git clone [https://github.com/justyntemme/zsh-deja-vu.git](https://github.com/justyntemme/zsh-deja-vu.git) \
     ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-deja-vu

2. Add zsh-deja-vu to the plugins list in your ~/.zshrc file:

   plugins=(
       # ... other plugins
       zsh-deja-vu
   )

Manual (No Plugin Manager)

1. Clone this repository somewhere:

   git clone [https://github.com/justyntemme/zsh-deja-vu.git](https://github.com/justyntemme/zsh-deja-vu.git) \
     ~/.zsh/zsh-deja-vu

2. Add this line to your ~/.zshrc:

   source ~/.zsh/zsh-deja-vu/zsh-deja-vu.plugin.zsh

3. Restart your shell (exec zsh).

Usage

1. Static History (djvu)

• Current Directory: Just type djvu.

  ~/projects/my-app > djvu
  --- Déjà Vu for . (~/projects/my-app) ---
       1  ls -la
       2  docker-compose up -d
       3  git status

• Another Directory: Pass any path as an argument.

  > djvu ~/docs
  --- Déjà Vu for ~/docs (~/docs) ---
       1  mkdocs serve
       2  ls

2. Interactive Search (djvi)

The plugin automatically binds djvi to Ctrl+F.

Just press Ctrl+F to open the interactive fuzzy finder ("F" for "Find"). You can type to filter all commands from all directories.

Overriding the Keybinding

If you want to use a different key (like Ctrl+R to replace the default), just add your own bindkey command to your ~/.zshrc file. Make sure to place it after your plugins are loaded. Your setting will override the default.

Example: to bind Ctrl+R:

# Put this in your ~/.zshrc (after the 'plugins=' line)
bindkey '^R' djvi-widget

Customization

You can change the location of the history log file by setting this variable in your ~/.zshrc before the plugin is sourced:

export ZSH_DEJA_VU_HISTORY_FILE="~/.my-custom-location"

License

MIT