> 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/documentation/ko/user-guide/installation/optional-dependencies-ripgrep-and-fzf.md).

# 선택적 종속성: ripgrep 및 fzf

Orbitron을 실행할 때 다음과 같은 경고 메시지가 표시될 수 있습니다:

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

이러한 메시지는 시스템에서 **선택적이지만 강력히 권장되는 도구**가 누락되었음을 나타냅니다.

***

### 🔍 `ripgrep (rg)`란 무엇인가요?

[`ripgrep`](https://github.com/BurntSushi/ripgrep)은 일반적으로 `rg`라고 불리며, 디렉토리에서 텍스트 패턴을 재귀적으로 검색하는 데 사용되는 빠른 검색 도구입니다. Orbitron은 대규모 코드베이스나 파일 트리에서 고성능 검색을 수행하기 위해 `ripgrep`을 사용합니다.

* **`ripgrep` 없이**: Orbitron은 더 느리고 덜 효율적인 검색 방법으로 대체됩니다.
* **`ripgrep` 사용 시**: 프로젝트 스캔, 파일 인덱싱 또는 콘텐츠 필터링과 같은 기능을 사용할 때 더 빠르고 정확한 검색 결과를 얻을 수 있습니다.

#### **✅ 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)는 명령줄에서 사용되는 범용 퍼지 파인더입니다. 사용자가 결과 목록에서 대화형으로 검색하고 선택할 수 있게 해줍니다.

* **`fzf` 없이**: 대화형 파일 선택, 퍼지 명령 팔레트, AI 컨텍스트 세분화와 같은 기능이 비활성화되거나 수동 입력이 필요할 수 있습니다.
* **`fzf` 사용 시**: 키보드 기반 선택 메뉴와 동적 필터링을 사용하여 워크플로우를 간소화할 수 있습니다.

#### **✅ fzf 설치**

* **macOS (Homebrew):**

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

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

  ```powershell
  scoop install fzf
  ```

***

#### 🛠 경고 해결 방법

1. 위의 지침을 사용하여 두 도구를 모두 설치하세요.
2. 설치된 바이너리가 시스템의 `$PATH`에 있는지 확인하세요.
3. 터미널을 다시 시작하고 Orbitron을 다시 실행하세요.

설치가 완료되면 경고 메시지가 사라지고 검색 및 퍼지 매칭에 의존하는 기능의 성능이 향상됩니다.