Directory Dive

Directory Dive is a VSCode extension that allows you to quickly search and navigate your project files. It includes features such as recent files, search history, bookmarks, and more.

Features

• Directory Dive: Quickly search for files by path.
• Recent Files: Access recently opened files easily.
• Search History: Re-run previous searches with ease.
• Bookmarks: Bookmark files for quick access.
• Show Bookmarks: List all bookmarked files and manage them.
• Remove Bookmarks: Easily remove bookmarks from the list.

Installation

1. Install from the Marketplace: Visual Studio Code Marketplace.
2. Reload VSCode: Open the Command Palette (Ctrl+Shift+P) and type Developer: Reload Window.

Usage

Activating Features

You can activate the features of Directory Dive either by using the command palette, the provided keybindings, or by interacting with the command pallette (Ctrl+Shift+P).

Keybindings

• Directory Dive: Ctrl+Shift+Alt+D
• Recent Files: Ctrl+Shift+Alt+R
• Search History: Ctrl+Shift+Alt+H
• Add Bookmark: Ctrl+Shift+Alt+B
• Show Bookmarks: Ctrl+Shift+Alt+K
• Remove Bookmark: Ctrl+Shift+Alt+Shift+B

Command Palette

1. Directory Dive: Quickly search for a file in your project.

   • Trigger: Open the Command Palette (Ctrl+Shift+P) and type Directory Dive.
   • Example: Type part of the file path to find and open the file. Eg; /home/usr/path or even components

2. Recent Files: Access a list of recently opened files.

   • Trigger: Open the Command Palette (Ctrl+Shift+P) and type Recent Files.
   • Example: Select from the list of recent files to open the desired file.

3. Search History: View and re-run previous searches.

   • Trigger: Open the Command Palette (Ctrl+Shift+P) and type Search History.
   • Example: Select from the list of previous search queries to re-run a search.

4. Add Bookmark: Bookmark the current file for quick access later.

   • Trigger: Open the Command Palette (Ctrl+Shift+P) and type Add Bookmark.
   • Example: Bookmark the currently open file for quick access later.

5. Show Bookmarks: Display all bookmarked files.

   • Trigger: Open the Command Palette (Ctrl+Shift+P) and type Show Bookmarks.
   • Example: Select from the list of bookmarked files to open or remove a bookmark.

6. Remove Bookmark: Remove a file from bookmarks.

   • Trigger: Open the Command Palette (Ctrl+Shift+P) and type Remove Bookmark.
   • Example: Remove the selected bookmark from the list.

Status Bar

1. View Bookmarked Files:
   • How to Use: Click the bookmark icon in the status bar to view all bookmarked files.
   • Example: Clicking the status bar item will display a list of all bookmarked files. You can select a file from the list to open or remove it.

Commands

Directory Dive

Quickly search for a file in your project.

• How to Use:
  1. Open the Command Palette (Ctrl+Shift+P).
  2. Type Directory Dive and press Enter.
  3. Type part of the file path to search for files in the project.
  4. Select a file from the list to open it.

Recent Files

Access a list of recently opened files.

• How to Use:
  1. Open the Command Palette (Ctrl+Shift+P).
  2. Type Recent Files and press Enter.
  3. Select a file from the list to open it.

Search History

View and re-run previous searches.

• How to Use:
  1. Open the Command Palette (Ctrl+Shift+P).
  2. Type Search History and press Enter.
  3. Select a previous search query from the list to re-run it.

Add Bookmark

Bookmark the current file for quick access later.

• How to Use:
  1. Open a file in the editor.
  2. Open the Command Palette (Ctrl+Shift+P).
  3. Type Add Bookmark and press Enter.
  4. The file is now bookmarked for quick access later.

Show Bookmarks

Display all bookmarked files.

• How to Use:

  1. Open the Command Palette (Ctrl+Shift+P).
  2. Type Show Bookmarks and press Enter.
  3. Select a bookmarked file from the list to open or remove it.

• Alternative Method:

  1. Click the bookmark icon in the status bar to view all bookmarked files.
  2. Select a file from the list to open or remove it.

Remove Bookmark

Remove a file from bookmarks.

• How to Use:
  1. Open the Command Palette (Ctrl+Shift+P).
  2. Type Remove Bookmark and press Enter.
  3. Select the bookmark to remove it from the list.

Contributing

Contributions are welcome! Please open an issue or submit a pull request on GitHub.

License

This project is licensed under the MIT License - see the LICENSE file for details.