> For the complete documentation index, see [llms.txt](https://orbitron.gitbook.io/orbitron-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://orbitron.gitbook.io/orbitron-docs/user-guide/installation/optional-dependencies-ripgrep-and-fzf.md).

# Optional Dependencies: ripgrep and fzf

When running Orbitron, you may see the following warning messages:

```
Ripgrep (rg) not found in $PATH. Some features might be limited or slower.
FZF not found in $PATH. Some features might be limited or slower.
```

These messages indicate that **optional but highly recommended tools** are missing from your system.

***

### 🔍 What is `ripgrep (rg)`?

[`ripgrep`](https://github.com/BurntSushi/ripgrep), commonly referred to as `rg`, is a fast search tool used to recursively search directories for text patterns. Orbitron uses `ripgrep` to perform high-performance searches across large codebases or file trees.

* **Without `ripgrep`**: Orbitron will fall back to slower, less efficient search methods.
* **With `ripgrep`**: You’ll get faster and more accurate search results when using features like project scan, file indexing, or content filtering.

#### **✅ Install ripgrep**

* **macOS (Homebrew):**

  ```bash
  brew install ripgrep
  ```
* **Linux (apt):**

  ```bash
  sudo apt install ripgrep
  ```
* **Windows (scoop):**

  ```powershell
  scoop install ripgrep
  ```

***

### 🔎 What is `fzf`?

[`fzf`](https://github.com/junegunn/fzf) is a general-purpose fuzzy finder used in the command line. It allows users to interactively search and select from a list of results.

* **Without `fzf`**: Features like interactive file selection, fuzzy command palette, or AI context refinement may be disabled or require manual input.
* **With `fzf`**: You can use keyboard-driven selection menus and dynamic filtering to streamline your workflow.

#### **✅ Install fzf**

* **macOS (Homebrew):**

  ```bash
  brew install fzf
  ```
* **Linux (apt):**

  ```bash
  sudo apt install fzf
  ```
* **Windows (scoop):**

  ```powershell
  scoop install fzf
  ```

***

#### 🛠 How to Fix the Warning

1. Install both tools using the instructions above.
2. Make sure the installed binaries are in your system's `$PATH`.
3. Restart your terminal and re-run Orbitron.

Once installed, the warning messages will disappear and performance will improve for features that rely on search and fuzzy matching.