FindItFaster installs statistics

FindItFaster

Finds files and text within files, but faster than VS Code normally does.

Make sure to check the Requirements below (TL;DR: have fzf, rg, bat on your PATH).

<hr />

Default key bindings:

• cmd+shift+j / ctrl+shift+j to search files,
• cmd+shift+u / ctrl+shift+u to search for text within files,
• cmd+shift+ctrl+u / ctrl+shift+alt+u to search for text within files with type pre-filtering.

You can change these using VS Code's keyboard shortcuts.

Recommended settings:

• set find-it-faster.general.useTerminalInEditor to true to have the extension window open in the editor panel rather than in the terminal panel.

<hr />

Native Windows support is now implemented (experimental)! Also see Known Issues.

<hr />

Features

This plugin is useful if you deal with very large projects with lots of files (which makes VS Code's search functionality quite slow), or when you simply love using fzf and rg and would like to bring those tools inside VS Code, similar to how the excellent fzf.vim plugin works for Vim.

This extension exposes four commands:

1. Search for files and open them. Uses a combination of fzf, rg, and bat.
2. Search within files for text and open them. Uses a combination of fzf, rg, and bat.
3. Like 2., but you can limit the file types that will be searched.
4. Resume search. Repeats the last run command with the previous query prepopulated.

If your active text editor has a selection, it will be used as the initial query (you can disable this setting).

⬇️  Find files

⬇️  Find text within files

⬇️  Find text within files, with file type filter

This extension has also been tested on remote workspaces (e.g. SSH sessions).

<hr />

<a name="requirements"></a>

Requirements

This plugin opens a terminal inside VS Code. Make sure that you can run fzf, rg, bat, and sed by running these commands directly in your terminal. If those work, this plugin will work as expected. If it doesn't, confirm that you are running recent versions of all three tools.

If you're not familiar with these command line tools, you might want to check them out. They are awesome tools that can be individually used and make you more productive. And when combined such as for instance in this extension, they're very powerful. They're available for many platforms and easy to install using package managers or by simply installing a binary.

• fzf ("command-line fuzzy finder")
• rg ("ripgrep")
• bat ("a cat clone with wings")

I have no affiliation with any of these tools, but hugely appreciate them, and wanted to bring them into a VS Code context.

<hr />

Extension Settings

See the settings for this extension in the GUI.
You might want to play with fzf, rg and bat on the command line and read their manuals in order to get a better understanding of some of the settings in this extension. It will be worth your time.

fzf can also be configured through various environment variables. This extension does nothing to disable that behavior, so feel free to use those. You can also check whether fzf is running inside this extension by checking whether the FIND_IT_FASTER_ACTIVE environment variable is set.

<hr />

<a name="known_issues"></a>

Known Issues

Windows. There are two ways of running this extension on Windows:

1. Natively using Powershell. This feature was added as of May 2022 and is experimental at this stage. Please file an issue on [Github](https://github.com/tomrijndorp/vscode-finditfaster/blob/main/ https:/github.com/tomrijndorp/vscode-finditfaster/issues) if you find one.
2. Through WSL (Windows Subsystem for Linux). You can run this extension inside a Remote-WSL workspace.

Not tested on Docker / Github code spaces. Will likely work without issues as the functionality is very similiar to other remote sessions (e.g. SSH, WSL).

Various small terminal issues. VS Code gives developers little control over the terminal. We can't know if you typed text into the terminal we create, so that might interfere with the extension. There are various subtle ways in which in which things can break, many of which can't be detected. That said, if you don't touch the FindItFaster terminal, things should work well!

NixOS:

The bash scripts use a shebang that conflicts with NixOs: #!/bin/bash , as bash isn't available in /bin, a work around is to this to follow the instructions in [Issue #44](https://github.com/tomrijndorp/vscode-finditfaster/issues/44) and change the shebangs manually, after this, the extention should work normally.

<hr />

FAQ…