peektea, WSL에서 구동 👀🍵 (한 줄 설치)

출처: Dev.to

안녕하세요, 저는 Maneshwar입니다. 매 커밋마다 실행되는 마이크로 AI 코드 리뷰어인 git‑lrc를 만들고 있습니다. 이 도구는 무료이며 GitHub에서 소스가 공개되어 있습니다. 프로젝트를 알리려면 git‑lrc에 별표를 눌러 주세요. 직접 사용해 보시고 피드백을 공유해 주세요.

두 가지 미뤄두던 일.

1️⃣ 첫 번째: Windows 사용자들이 peektea가 WSL에서 동작하는지 물었습니다. 이제 동작합니다.
2️⃣ 두 번째: “소스에서 brew 설치”는 최소한의 도구에 어울리지 않는 복잡한 설치 방식이었습니다. 이것도 해결했습니다.

데모 보기 (위 미리보기가 보이지 않을 경우)

---

WSL 지원

WSL은 Linux 환경이며, peektea는 Linux에서 동작합니다. 지금까지는 문제 없었습니다.

문제는 파일을 열 때 사용하는 o 키였습니다.

일반 Linux에서는 o를 눌러 이미지 파일을 열면 feh 혹은 eog가 실행됩니다. 하지만 WSL에는 Linux GUI 앱이 없으므로 호출이 조용히 실패하거나 오류가 출력됩니다.

peektea는 이제 시작 시 WSL을 감지합니다:

func IsWSL() bool {
    if os.Getenv("WSL_DISTRO_NAME") != "" {
        return true
    }
    data, err := os.ReadFile("/proc/version")
    return err == nil && strings.Contains(strings.ToLower(string(data)), "microsoft")
}

Enter fullscreen mode
Exit fullscreen mode

WSL이 감지되면 파일 열기 명령을 wslview( wslu 에서 제공) 로 시도하고, 설치되어 있지 않다면 explorer.exe 로 대체합니다:

func WSLOpener() string {
    if _, err := exec.LookPath("wslview"); err == nil {
        return "wslview"
    }
    if _, err := exec.LookPath("explorer.exe"); err == nil {
        return "explorer.exe"
    }
    if _, err := os.Stat("/mnt/c/Windows/explorer.exe"); err == nil {
        return "/mnt/c/Windows/explorer.exe"
    }
    return ""
}

Enter fullscreen mode
Exit fullscreen mode

추가적인 문제: Windows 프로그램은 /home/taco/file.png 와 같은 Linux 경로를 읽을 수 없습니다. 대신 \\wsl.localhost\Ubuntu\home\taco\file.png 와 같은 UNC 경로가 필요합니다.

WSL은 이를 위해 wslpath 를 제공합니다:

func WindowsPath(path string) string {
    out, err := exec.Command("wslpath", "-w", path).Output()
    if err != nil {
        return path
    }
    return strings.TrimSpace(string(out))
}

Enter fullscreen mode
Exit fullscreen mode

구성된 오프너가 .exe 로 끝나는 경우, 명령 실행 전에 경로가 변환됩니다. wslview 는 자체적으로 변환을 처리하므로 변환이 필요 없고, 순수 explorer.exe 만 변환이 필요합니다.

Bubble Tea(https://github.com/charmbracelet/bubbletea) 로 만든 최소한의 터미널 파일 브라우저입니다.

화살표 키(또는 vim 키)로 파일 시스템을 탐색하고, 선택한 파일을 미리 설정해 둔 앱으로 바로 열어볼 수 있습니다.

데모

시작하기 전에 한 번 살펴보세요:

설치

한 줄 명령:

curl -fsSL https://raw.githubusercontent.com/lovestaco/peektea/master/scripts/install.sh | sh

Enter fullscreen mode
Exit fullscreen mode

바이너리 다운로드 (Go 필요 없음) — 최신 릴리즈 페이지에서 현재 플랫폼에 맞는 파일을 받아 주세요: releases page

압축을 풀고 peektea 실행 파일을 $PATH 안의 어느 디렉터리든 넣어 주세요.

Go 로 설치:

go install github.com/lovestaco/peektea@latest

Enter fullscreen mode
Exit fullscreen mode

소스에서 직접 빌드:

git clone https://github.com/lovestaco/peektea
cd peektea
make install

Enter fullscreen mode
Exit fullscreen mode

make install 은 바이너리를 ~/go/bin 에 복사하고, $PATH 설정을 자동으로 처리합니다.

• 이미 $PATH 에 포함돼 있으면 바로 사용 가능 — 별도 작업 필요 없음.
• ~/.local/bin 이 $PATH 에 있다면 그곳에 심볼릭 링크를 만들고 현재 쉘에서도 즉시 동작합니다.
• 둘 다 아니라면 ~/go/bin 을 .bashrc 에 추가합니다…

peektea init on WSL

일반 Linux 머신에서 peektea init 은 텍스트 편집기, 파일 매니저, 이미지 뷰어, PDF 뷰어 등을 설치된 프로그램 중에서 선택하도록 합니다.

하지만 WSL 환경에는 GUI 앱이 거의 없기 때문에 선택지가 없어서 불편합니다.

그래서 WSL에서는 해당 카테고리를 건너뛰고, xdg-open 대신 Windows 오프너를 기본값으로 설정합니다.

텍스트 편집기 설정(vim, nvim, nano 등)은 그대로 유지되며, 시각적인 부분은 Windows 쪽에서 처리합니다.

[](https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Farticles%