Jarvy

개발 환경 as 코드

jarvy.toml 파일을 버전 관리하여 위키 페이지나 구두 지식을 대체합니다. 이 파일은 저장소에 커밋되어 팀원 모두가 동일한 도구와 버전을 사용하도록 보장합니다.

크로스플랫폼 지원

동일한 jarvy.toml 설정으로 macOS, Linux, Windows에서 작동합니다. 각 운영체제의 네이티브 패키지 매니저(Homebrew, apt/dnf/pacman/apk, winget/Chocolatey/Scoop)를 활용합니다.

로컬 및 오프라인 동작

클라우드 의존성이나 컨테이너 오버헤드 없이 로컬에서 직접 실행됩니다. 네트워크 연결이 없어도 이전에 설치된 도구는 재설치하지 않고 건너뜁니다.

안정성과 멱등성

반복 실행 시 이미 설치된 도구는 감지하여 건너뛰고, 누락된 도구만 설치합니다. 이로 인해 환경 drift가 발생해도 안전하게 재설정할 수 있습니다.

언어 생태계 지원

[npm], [pip], [cargo], [nuget], [gem], [go] 섹션을 통해 언어별 패키지 매니저로 언어 런타임과 함께 의존성을 설치할 수 있습니다.

AI 에이전트 통합

[ai_hooks]로 가드레일을 배포하고, [mcp_register]로 MCP 서버를 등록하며, [skills]로 AI 스킬을 Claude Code, Cursor, Codex, Windsurf, Cline, Continue 등에서 사용할 수 있도록 배포합니다.

Git 후크 통합

[git_hooks.native]를 통해 인라인 스크립트, 로컬 폴더, 또는 공유 팀 저장소에서 직접 .git/hooks/에 스크립트를 작성하여 서드파티 프레임워크 없이 Git 후크를 관리할 수 있습니다.

라이브러리 레지스트리

재사용 가능한 AI 후크, MCP 서버, 스킬을 HTTPS URL에 게시하고, jarvy.toml에서 use = “이름” 형태로 참조할 수 있습니다.

다운로드·설치 방법

Windows PowerShell에서 다음 명령으로 Jarvy를 설치할 수 있습니다:

irm https://raw.githubusercontent.com/Cliftonz/jarvy/main/dist/scripts/install.ps1 | iex

또는 다음 방법으로도 설치 가능합니다:

• Cargo: cargo install jarvy
• Homebrew (WSL2 등): brew install jarvy
• GitHub Releases에서 바이너리 다운로드

설치 후 버전 확인 명령은 다음과 같습니다:

jarvy –version

기본 사용법/명령어

새 프로젝트에서 개발 환경을 설정하는 기본 흐름은 다음과 같습니다:

1. 대화형 마법사로 jarvy.toml 생성:

   jarvy init

2. 또는 템플릿에서 시작 (예: React, Rust CLI, Python API, K8s 관리):

   jarvy init –template react

3. 설정 파일을 기반으로 환경 프로비저닝 실행:

   jarvy setup

이 명령은 jarvy.toml에 명시된 모든 도구를 확인하고, 누락된 도구만 설치하며, 이미 설치된 도구는 버전을 확인하여 건너뜁니다.

이런 경우에 유용합니다

새 팀원이 합류했을 때, 한 줄 명령으로 동일한 개발 환경을 빠르게 구축해야 하는 경우에 유용합니다. jarvy.toml을 저장소에 커밋하고 README에 설정 방법을 추가하면, 새로운 구성원은 저장소를 클론하고 jarvy setup만 실행하여 바로 개발을 시작할 수 있습니다.

여러 프로젝트를 동시에 작업하면서 각기 다른 도구 버전이 필요한 경우에도 유용합니다. 각 프로젝트 폴더에 별도의 jarvy.toml을 두어 프로젝트별로 격리된 환경을 유지할 수 있습니다.

보안 감사나 규제 준수를 위해 모든 도구의 정확한 버전을 추적해야 하는 경우에도 유용합니다. jarvy.toml에 버전을 명시하면 해당 버전이 저장소에 기록되어 감사 대상이 됩니다.

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

Jarvy는 Windows 10 이상에서 실행되며, winget 또는 Chocolatey와 같은 Windows 패키지 매니저가 정상적으로 작동해야 합니다. 관리자 권한이 필요한 도구 설치를 위해 사용자 계정에 적절한 권한이 있어야 하며, 일부 도구는 재부팅이 필요할 수 있습니다.

최신 버전·업데이트

현재 버전은 0.8.3이며, 안정 채널(stable), 베타 채널(beta), 나이트리 채널(nightly) 중 선택하여 업데이트 채널을 관리할 수 있습니다. 베타 채널은 릴리스 전 기능을 미리 테스트하고 싶은 사용자에게 적합합니다.

채널을 지정하여 업데이트하는 방법은 다음과 같습니다:

jarvy update –channel beta

또는 ~/.jarvy/config.toml 파일에 다음을 추가하여 영구적으로 설정할 수 있습니다:

[update]
channel = “beta”

제한 사항·확인 사항

Jarvy는 관리자 권한이 필요한 일부 도구 설치를 위해 사용자 계정에 적절한 권한이 필요하며, 기업 환경에서 그룹 정책으로 패키지 관리가 제한된 경우 일부 기능이 작동하지 않을 수 있습니다. 또한, 특정 도구의 설치는 해당 도구의 라이선스 조건에 따릅니다.

FAQ

• Jarvy는 무료로 사용할 수 있나요?

  네, Jarvy는 MIT 또는 Apache-2.0 라이선스 하에 오픈소스로 제공되어 무료로 사용할 수 있습니다.

• 인터넷 연결이 필수인가요?

  초기 설치를 위해서는 인터넷 연결이 필요하지만, 한 번 설치된 도구는 오프라인 상태에서도 재설치 없이 사용할 수 있습니다. 다만, 최신 버전으로 업데이트하거나 새로운 도구를 설치하려면 인터넷이 필요합니다.

• Windows에서 관리자 권한이 필요한가요?

  일부 도구 설치를 위해서는 관리자 권한이 필요할 수 있지만, Jarvy 자체는 일반 사용자 권한으로 설치 및 실행이 가능합니다. 권한이 필요한 작업은 사용자 계정 통제(UAC) 프롬프트를 통해 요청됩니다.