context-labs/whip

whip – Go로 작성된 빠른 코딩 에이전트 하네스

개요 – whip은 LLM 기반의 "도구 사용" 루프를 실행하는 단일 바이너리 명령줄 도구입니다. Bubble Tea로 구축된 대화형 터미널 UI를 통해 언어 모델이 파일을 읽고, 쓰고, 편집하며, bash 명령을 실행하고, 심지어 하위 에이전트를 생성할 수 있도록 합니다.

존재 이유 – 기존 에이전트 하네스는 속도가 느리거나 복잡한 설정이 필요하다는 단점이 있습니다. Go의 동시성 기본 요소(channels, goroutines)를 활용하여 병렬 도구 호출과 응답 스트리밍을 구현함으로써 모델에서 사용자까지의 경로를 최대한 단축했습니다.

주요 기능 (README 설명 기준)

• 속도 중심 설계 – 병렬 도구 호출, 스트리밍 I/O, 추가 런타임 계층 없음.
• 독자적인 기본값 – pi, opencode, codex, exo와 같은 프로젝트의 아이디어를 통합했으며, 로드맵 파일에 각 출처가 명시되어 있습니다.
• 제공업체 라우팅 모델 – OpenAI 호환 엔드포인트와 작동합니다. OpenRouter와 같은 제공업체가 제공하는 모든 모델을 자동으로 검색하므로 모델별 설정이 필요 없습니다.
• 내장 모델 검색 – whip auth openrouter로 전체 OpenRouter 카탈로그를 로드하고, whip auth codex로 API 키 대신 ChatGPT/Codex 구독을 사용하여 로그인할 수 있습니다.
• 자동 토큰 처리 – 로그인 토큰은 로컬(~/.codex/auth.json)에 저장되고 백그라운드에서 갱신되므로 프롬프트에 노출되지 않습니다.
• MCP 지원 – 저장소에 .mcp.json 파일을 배치하면 "MCP 서버"가 나타나며 /mcp 명령으로 액세스할 수 있습니다.
• 테마 – /theme 명령으로 터미널 색상 테마를 미리 보고 선택할 수 있습니다.
• 편의 명령 –
  • /context-doctor – 새 세션의 토큰 사용량을 감사합니다.
  • /goal <text> – 목표가 달성될 때까지 에이전트가 작업하도록 지시합니다.
  • /model – 제공업체 카탈로그의 실시간 업데이트를 포함하여 모델을 대화형으로 선택합니다.
  • /usage – Codex 구독의 속도 제한 정보를 표시합니다.

설치

# 원라인 설치 프로그램 (Linux/macOS용 체크섬 검증 바이너리 다운로드)
curl -fsSL https://raw.githubusercontent.com/context-labs/whip/main/install.sh | sh

또는 소스에서 설치 (Go ≥ 1.27 필요):

go install github.com/context-labs/whip/cmd/whip@latest

설치 후 whip 명령을 바로 사용할 수 있습니다.

업데이트 – whip update를 실행하면 설치 스크립트가 다시 실행되어 최신 릴리스를 가져옵니다.

문서 – 저장소의 docs/ 폴더에는 아키텍처, 에이전트 루프, 동시성 모델, 전체 기능 맵, 그리고 구현된 기능과 향후 작업을 구분한 로드맵이 포함된 상세한 markdown 파일이 있습니다.

첫 단계

/context-doctor   # 토큰 주입 세부 정보 확인
/goal Build a simple CLI tool
/model            # 모델 선택 (입력하여 필터링)
/theme            # 터미널 테마 선택

Ctrl-C를 한 번 누르면 현재 작업이 중단되고, 두 번 누르면 프로그램이 종료됩니다.

---

위의 모든 정보는 저장소의 README에서 직접 가져온 것이며, 추가적인 가정은 포함되지 않았습니다.