qsh: 터미널을 위한 경량 LLM CLI 도구

섹션별 상세

터미널 세션의 맥락을 파악하기 위해 쉘 후크 시스템을 사용한다. 사용자가 q install-hook을 실행하면 .zshrc 또는 .bashrc에 명령 이력을 기록하는 스크립트가 추가되며, 이를 통해 최근 터미널 출력을 LLM에 컨텍스트로 제공한다. q-stop과 q-start 명령어를 통해 대화형 도구 사용 시 로그 기록을 일시 중지하거나 재개할 수 있는 유연성을 갖췄다.

다양한 LLM 프로바이더와 모델을 환경 변수 설정만으로 교체하여 사용할 수 있다. 기본값인 OpenAI 외에도 Anthropic의 네이티브 포맷, AWS Nova, Azure OpenAI 등을 지원하며 로컬에서 실행 중인 Ollama와도 연동이 가능하다. Q_PROVIDER, Q_MODEL, Q_ENDPOINT 변수를 조합하여 사용자의 워크플로에 맞는 최적의 모델을 터미널에서 즉시 호출한다.

근거

OpenAI, Anthropic, AWS Nova, Azure 등 주요 LLM 프로바이더를 모두 지원한다. — Providers 섹션의 표

보안을 위해 컨텍스트 전송 전 민감 정보를 가리는 qignore 기능을 제공한다. q ignore add 명령어로 특정 단어나 환경 변수명을 등록하면 LLM API로 데이터를 보내기 전에 해당 패턴을 자동으로 식별하여 제거한다. 이는 API 키나 비밀번호가 포함된 터미널 로그가 외부 서버로 유출되는 것을 방지하는 핵심 안전 장치이다.

근거 모음

근거

qsh는 curl과 jq만을 의존성으로 가지며 jq가 없을 경우 자동 설치를 시도한다. — README.md의 Deps 섹션

기술

Shell
curl
jq
OpenAI API
Anthropic API
Ollama

활용 사례

터미널 명령 실행 오류 즉시 분석
정규 표현식 및 복잡한 명령어 설명
터미널 컨텍스트 기반 코드 리팩터링 제안

언급된 리소스

GitHubqsh GitHub Repository