fuzzy-files

Quickly find and take an action over project files. Designed as a replacement for fuzzy-finder with fuzzy search, multiple actions, and package integrations.

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).

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.

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+\) 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.

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.

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's welcome!