openGyver

openGyver란?

openGyver는 Go 기반 오픈소스 스위스아미나이프 CLI 도구로, 일상적인 변환 및 유틸리티를 위한 47개 명령어와 180+ 서브커맨드를 제공합니다. 인코딩/디코딩, 해싱, 파일 포맷팅, 검증, 생성(예: 비밀번호, QR 코드, UUID), 시간 관련 도우미 등의 작업을 다룹니다.

이 프로젝트는 Linux, macOS, Windows에서 단독 싱글 바이너리 실행 파일로 동작하도록 설계되었으며, CI/CD 파이프라인, 쉘 스크립트, AI 에이전트 같은 자동화 워크플로에 연동할 수도 있습니다.

주요 기능

• Linux, macOS, Windows용 제로 의존성 싱글 바이너리 Go CLI로, 일반 환경에서 동일 도구 실행 가능.
• 광범위한 변환 지원: 단위 및 통화 변환(9개 카테고리, 38개 통화), 오디오·문서/스프레드시트·이미지·비디오·벡터 그래픽·폰트·프레젠테이션·CAD 등 일반 형식 파일 변환.
• 인코딩, 해싱, 체크섬 유틸리티: Base64/Base32/Base58/URL/HTML/hex/binary, ROT13 및 Morse, MD5, SHA-1/SHA-2 변형, HMAC/bcrypt 등.
• 데이터 및 포맷 도구: JSON 포맷/검증, YAML/TOML/XML/CSV 변환, HTML/XML/CSS/SQL 포맷/축소, 파일 diff(text/json/csv).
• 일반 아티팩트 생성 명령어: 비밀번호, API 키/시크릿, OTP, nanoid/snowflake/short ID, UUID v4/v6, QR/바코드 생성(터미널 ASCII, QR용 PNG/SVG).
• 명령어당 다중 출력 모드(JSON 출력으로 스크립팅, 단일 값 축약 출력, 파일 변환기용 확인 메시지 억제 조용 모드).

openGyver 사용법

1. 리포지토리에 나오는 옵션 중 하나로 설치: Homebrew(탭経由), Go install, 또는 go build로 소스 빌드.
2. 작업에 맞는 간단한 명령어로 시작. 프로젝트 예시: 단위 변환(convert), 인코딩(encode), 해싱(hash), 생성(generate password).
3. 스크립트나 자동화 연동 시 --json/-j로 구조화 결과, 파일 변환용 --quiet/-q로 상호작용 메시지 줄임.

사용 사례

• 쉘에서 단위 및 통화 변환: 예: openGyver convert 100 cm in 또는 openGyver convert 100 usd eur로 변환값 확인.
• 커스텀 스크립트 없이 문자열 인코딩/해싱: openGyver encode base64 "hello world", openGyver hash sha256 "hello".
• 식별자 및 보안 테스트 데이터 생성: openGyver generate password --length 32(비밀번호), openGyver uuid(UUID v4 랜덤), openGyver testdata person --count 5 -j(JSON 가짜 레코드).
• 명령줄에서 문서/스프레드시트 변환: convertFile로 CSV/XLSX/MD/HTML/DOCX/PDF/PS 등 형식 변환(출력 -o, 조용 -q 옵션).
• 개발 중 마크업/데이터 형식 검증 및 포맷: openGyver validate html --file index.html, openGyver json format(format/beautify/minify), 변경 검토 시 diff(text/json/csv)로 파일 비교.

자주 묻는 질문

• openGyver는 컴파일된 바이너리로 제공되나요? 리포지토리에서 Linux, macOS, Windows용 “제로 의존성 싱글 바이너리 배포”로 Go 빌드된다고 명시.

• 자동화 및 스크립팅에 사용할 수 있나요? 네. 각 명령어가 JSON 출력(--json/-j) 및 조용 모드(--quiet/-q)를 지원해 파이핑 및 스크립팅에 유용.

• 설치 방법은? Homebrew, Go(go install github.com/mj/opengyver@latest), git clone 및 go build로 소스 빌드 등 설치 옵션 나열.

• AI 도구/에이전트와 함께 사용할 수 있나요? 리포지토리에서 Claude Code 플러그인이 “네이티브 MCP 도구” 설치하며, 플러그인 마켓플레이스 설정 및 opengyver 설치/플러그인 재로드 예시 언급.

• 어떤 변환을 지원하나요? README에 단위 및 통화 변환 명령어, 오디오·CAD·전자책·문서/스프레드시트·폰트·이미지·프레젠테이션·벡터·비디오 등 다중 파일 형식 변환 나열.

대안

• 범용 파일 변환 도구 세트 (예: 미디어 및 문서 변환 CLI 도구): 특정 도메인에서 더 광범위할 수 있지만, openGyver는 변환 외에 인코딩/해싱/검증/생성 워크플로를 하나의 CLI로 제공합니다.
• 스크립트 기반 변환 방식 (셸 스크립트나 언어 라이브러리 호출 소규모 프로그램): 유연하지만 여러 도구를 조합하고 포맷/검증/출력을 직접 처리해야 합니다; openGyver는 일반 작업을 하나의 명령 인터페이스에 통합합니다.
• 인코딩/해시/포맷 작업에 초점을 맞춘 다른 CLI 유틸리티 컬렉션: 필요에 따라 부분(예: 인코딩/해싱만)을 커버할 수 있지만, openGyver는 변환, 생성기, 검증, 구조화된 출력 모드를 포괄합니다.
• 전용 데이터 포맷/검증 도구: 한 포맷에 더 특화될 수 있지만, openGyver는 JSON/quiet 출력 옵션이 있는 하나의 CLI로 다중 포맷 워크플로를 제공합니다.