yoo

프로젝트 및 Git 컨텍스트 요약

`yoo` 명령을 실행하면 현재 프로젝트의 이름, Git 브랜치 및 커밋 상태(예: main · clean)를 포함한 기본 세션 요약을 보여줍니다. 이는 작업 중인 저장소의 상태를 한눈에 파악하는 데 유용합니다.

도구 및 환경 진단 (doctor)

`yoo doctor` 명령은 로컬에 설치된 개발 도구들의 상태를 확인하고, 프로젝트가 올바르게 감지되었는지 및 구성 파일이 존재하는지 점검합니다. 개발 환경의 문제를 빠르게 진단하는 데 사용됩니다.

프로젝트 메타데이터 상세 보기

`yoo project` 명령은 프로젝트의 이름, 소스 파일 수, 언어 통계, Git 커밋 히스토리 및 저장소 정보를 상세히 출력합니다. `–json` 플래그를 사용하면 기계가 읽기 쉬운 형식으로 결과를 얻을 수 있습니다.

개발 환경 종합 리포트

`yoo fetch` 명령은 프로젝트 정보에 더해 설치된 툴체인, 런타임, 프레임워크 및 환경 변수까지 포함한 전체 개발 환경을 종합적으로 보고합니다. `–plain` 플래그로 아트 없이 깔끔한 텍스트 출력을 얻을 수 있습니다.

코딩 세션 타이머

`yoo session [MINUTES]` 명령은 지정된 시간(기본 25분) 동안의 로컬 코딩 세션 타이머를 시작합니다. 이는 포모도로 기법과 유사하게 집중력을 관리하는 데 도움이 됩니다.

설정 및 팁 관리

`yoo tip` 또는 `yoo tips`는 사용자가 설정한 알림 팩을 보여주고, `yoo edit`는 구성된 편집기로 현재 프로젝트를 엽니다. `yoo init` 또는 `yoo config`로 로컬 설정을 생성하거나 확인할 수 있으며, `yoo completions SHELL`로 Bash, Zsh, Fish, PowerShell용 셸 완성 스크립트를 생성할 수 있습니다.

다운로드·설치 방법

Windows 사용자는 다음 중 하나의 방법으로 yoo를 설치할 수 있습니다.

• WinGet을 사용하는 경우: winget install --id Nihitdev.yoo --exact
• Chocolatey를 사용하는 경우: choco install yoo
• Rust가 설치되어 있다면 Cargo로 직접 설치: cargo install yoo
• 검증된 설치 스크립트 사용: curl --proto '=https' --tlsv1.2 -LsSf https://yo-cli.vercel.app/yo-setup | sh

설치 후에는 어떤 프로젝트 폴더에서도 yoo 명령을 실행하여 즉시 프로젝트 상태를 확인할 수 있습니다.

기본 사용법/명령어

프로젝트 루트에서 터미널을 열고 다음 명령들을 사용할 수 있습니다.

• yoo: 기본 세션 요약 (프로젝트 이름, Git 상태 등)
• yoo doctor: 개발 도구 및 환경 진단
• yoo project: 프로젝트 메타데이터 상세 보기 (--json으로 JSON 출력 가능)
• yoo fetch: 프로젝트 + 개발 환경 종합 리포트 (--plain으로 깔끔한 출력)
• yoo session 25: 25분 코딩 세션 타이머 시작
• yoo tip: 설정된 알림 팁 표시
• yoo edit: 구성된 편집기로 현재 프로젝트 열기
• yoo init: 로컬 설정 파일 생성 또는 확인
• yoo completions powershell: PowerShell용 탭 완성 스크립트 생성

출력 형식은 --fast로 아트 제거, --plain으로 순수 텍스트, --theme NAME으로 테마 변경(네온, 오션, 드라큘라 등)을 조정할 수 있습니다.

이런 경우에 유용합니다

여러 프로젝트를 번갈아 가며 작업하는 개발자가 현재 디렉터리의 Git 브랜치와 커밋 상태를 빠르게 확인해야 할 때 유용합니다. 또한 새로 클론한 저장소에서 필수 도구가 모두 설치되었는지 점검하거나, 장시간 코딩 중 집중력을 유지하기 위해 세션 타이머를 설정하고 싶은 경우에도 도움이 됩니다. 계정 없이 로컬에서만 작동하므로 프라이버시가 중요한 환경에서도 안전하게 사용할 수 있습니다.

지원 환경·시스템 요구사항

yoo는 Windows 10 이상에서 실행되며, 공식적으로는 크로스플랫폼 바이너리를 제공합니다. Windows에서는 Winget, Chocolatey 또는 직접 다운로드한 실행 파일을 통해 설치할 수 있으며, 별도의 런타임이나 의존성이 필요하지 않습니다. 소스에서 빌드하려면 Rust 1.85 이상과 Cargo가 필요하지만, 일반 사용자는 사전 빌드된 바이너리를 사용하면 됩니다.

최신 버전·업데이트

현재 버전은 0.6.3이며, GitHub 저장소의 릴리스 페이지에서 최신 버전 및 업데이트 내역을 확인할 수 있습니다. 업데이트는 각 플랫폼의 패키지 관리자(Winget, Chocolatey, Cargo 등)를 통해 진행할 수 있습니다.