kazupon/gunshi
Gunshi: JavaScript command-line library, your strategist for CLIs that people and AI agents use
해결하는 문제
Gunshi는 현대적인 명령줄 인터페이스 구축의 복잡성을 해결합니다. 개발자는 종종 인수 파싱, 하위 명령 처리, 타입 안전성 보장, 그리고 사람과 자동화된 AI 에이전트 모두가 사용하기 쉬운 CLI를 만드는 데 어려움을 겪습니다. Gunshi는 최소한의 보일러플레이트로 명령을 정의할 수 있는 구조화된 방법을 제공합니다.
작동 방식
인수(타입, 기본값, 설명 포함)와 명령 로직을 실행하는 run 함수를 지정하여 명령을 객체로 정의합니다. 하위 명령은 subCommands 옵션을 통해 추가할 수 있습니다. Gunshi는 process.argv로부터 인수를 파싱하고 파싱된 값에 대한 타입 안전한 접근을 제공합니다. 도움말 및 오류 렌더링을 위한 플러그인 시스템을 사용하며, 다국어 출력을 위한 국제화를 지원하고, CLI가 AI 에이전트에 의해 사용되는지 감지하여 출력(예: JSON 생성)을 조정할 수 있습니다. 지연 로딩을 통해 하위 명령은 필요할 때만 로드됩니다.
대상 사용자
견고하고 유지보수가 쉬운 CLI를 만들고자 하는 개발자를 위한 도구입니다. 특히 CLI를 AI 에이전트가 접근할 수 있도록 만들 계획이거나, 명령 인수의 타입 안전성이 필요하거나, 많은 하위 명령을 가진 CLI를 모듈화하려는 경우에 매우 유용합니다. 국제화 지원 덕분에 글로벌 도구 개발에도 적합합니다.
주요 특징
- 타입 안전한 파싱을 지원하는 간단하고 선언적인 명령 정의.
- AI 에이전트를 위해 구축: JSON 출력 및 AI 사용 감지 가능.
- 공유 컨텍스트와 지연 로딩을 지원하는 구성 가능한 하위 명령.
- 유연한 렌더링: 도움말, 사용법, 오류 메시지 커스터마이징.
- 국제화 및 로케일 인식 설계.
- 라이프사이클 훅을 포함한 플러그인 시스템.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트