fuzzy-files

Quickly find and take an action over project files.

Fork of fuzzy-finder.

Features

• Fast fuzzy search: Uses algorithm with smart scoring. Results are ranked by match quality, adjusted by relative distance from the active editor file and directory depth. Files closer to your current context appear higher.
• Line navigation: Jump to specific line using : syntax (e.g., file.js:42).
• Multiple projects: Supports multiple project paths.
• Real-time updates: Auto-refreshes on file create/delete/rename.
• file-icons: Display file icons in the list.
• open-external: (Alt+Enter) Open files with external applications.
• claude-chat: (Alt+F) Attach file to Claude chat context.
• windows-clip: (Alt+W Alt+C/X) Copy/cut file to Windows clipboard (Windows only).
• tree-view-plus: (Alt+T) Reveal selected file in tree view.

Installation

To install fuzzy-files search for fuzzy-files in the Install pane of the Pulsar settings or run ppm install fuzzy-files. Alternatively, you can run ppm install asiloisad/pulsar-fuzzy-files to install a package directly from the GitHub repository.

Note: This package automatically disables the built-in fuzzy-finder package to avoid conflicts.

Commands

Commands available in atom-workspace:

• fuzzy-files:toggle: Ctrl+P toggle fuzzy files panel,
• fuzzy-files:update: refresh file cache.

Commands available in .fuzzy-files:

• select-list:open: Enter open file,
• select-list:open-external: Alt+Enter open file externally,
• select-list:show-in-folder: Ctrl+Enter show in folder,
• select-list:trash: Alt+Delete move file to trash,
• select-list:split-left/right/up/down: Alt+Left/Right/Up/Down open in split pane,
• select-list:update: F5 refresh file index,
• select-list:copy-r: Alt+C copy relative path,
• select-list:copy-p: Alt+C Alt+P copy project path,
• select-list:copy-a: Alt+C Alt+A copy absolute path,
• select-list:copy-n: Alt+C Alt+N copy file name,
• select-list:insert-r: Alt+V insert relative path,
• select-list:insert-p: Alt+V Alt+P insert project path,
• select-list:insert-a: Alt+V Alt+A insert absolute path,
• select-list:insert-n: Alt+V Alt+N insert file name,
• select-list:default-slash: Alt+0 use default separator,
• select-list:forward-slash: Alt+/ use forward slash,
• select-list:backslash: Alt+</kbd> use backslash,
• select-list:query-item: Alt+Q set query from selected item path,
• select-list:query-selection: Alt+S set query from editor selection,
• select-list:reveal-in-tree-view: Alt+T reveal selected file in tree view (requires tree-view-plus).

Provided Service fuzzy-files.score-modifier

Allows other packages to register functions that modify the score of search results. Consumer packages can use this to boost or penalize specific files in the ranking.

In your package.json:

{
  "consumedServices": {
    "fuzzy-files.score-modifier": {
      "versions": { "^1.0.0": "consumeScoreModifier" }
    }
  }
}

In your main module:

consumeScoreModifier(service) {
  return service.add((score, item) => {
    // item: { fPath, aPath, pPath, nPath, rPath, distance }
    return score * multiplier;
  });
}

Consumed Service atom.file-icons

Displays file type icons next to entries in the file list. Provided by file-icons.

Consumed Service open-external

Opens files with external applications via Alt+Enter. Provided by open-external.

Consumed Service claude-chat

Attaches selected files to the Claude chat context via Alt+F. Provided by claude-chat.

Consumed Service windows-clip

Copy and cut files to the Windows clipboard via Alt+W. Provided by windows-clip.

Consumed Service tree-view-plus

Reveals the selected file in the tree view via Alt+R. Provided by tree-view-plus.

Contributing

Got ideas to make this package better, found a bug, or want to help add new features? Just drop your thoughts on GitHub. Any feedback is welcome!