Kile-Thomson/Rokket-GSD

Mario Zechner의 Pi Mono를 기반으로 한 Glittercowboy (Lex Christopherson)의 gsd-pi를 바탕으로 구축되었습니다. ❤️

gsd-pi AI 코딩 에이전트(AI coding agent)를 위한 풀 기능 VS Code 프론트엔드(frontend)입니다.

스트리밍 응답(Streaming responses), 40개 이상의 도구 시각화(tool visualizations), 음성 전사(voice transcription) 기능이 포함된 Telegram 릴레이(Telegram relay), 병렬 워커 대시보드(parallel worker dashboards), 모델 제어(model controls), 4가지 내장 테마, 그리고 심층적인 워크플로 통합(workflow integration)을 제공합니다.

Rokket GSD는 gsd-pi CLI를 네이티브 VS Code 경험으로 전환합니다. 스트리밍 응답, 40개 이상의 도구 시각화, 음성 전사가 포함된 Telegram 릴레이, 병렬 워커 대시보드, 모델 제어, 4가지 내장 테마, 그리고 심층적인 워크플로 통합을 제공합니다. 모든 기능은 에디터 내부에서 실행됩니다.

이 확장 프로그램(extension)은 JSON-RPC (gsd --mode rpc)를 통해 GSD를 자식 프로세스(child process)로 생성하며, 이를 통해 에이전트가 워크스페이스(workspace), 도구, 구성된 프로바이더(providers)에 대한 완전한 액세스 권한을 갖는 동시에 사용자는 그 위에 적절한 UI를 사용할 수 있습니다.

|
🔄 📂 ⌨️ 🧠 🎯 🎨 |
💬 🔧 📊 ⚡ 💰 🛡️ 📡 🎙️ 🧪 |

중요

Rokket GSD는 GSD 에이전트를 위한 프론트엔드입니다. 에이전트 자체를 포함하고 있지 않습니다.

설치하기 전에 작동하는 GSD 환경이 필요합니다:

Node.js 18+ (npm 포함)
Git
VS Code 1.94+
전역(globally)에 설치된 gsd-pi:
npm install -g gsd-pi

GSD에 구성된 AI 프로바이더(AI provider) (API 키 또는 OAuth를 통한 Anthropic, OpenAI, Google 등)

팁

확장 프로그램을 설치하기 전에 터미널에서 gsd를 먼저 실행하여 작동 여부를 확인하세요. 터미널에서 gsd가 작동하지 않으면 확장 프로그램도 작동하지 않습니다.

확장 프로그램 사이드바에서 **"Rokket GSD"**를 검색하거나 VS Code Marketplace에서 직접 설치하세요.

curl -sL https://raw.githubusercontent.com/Kile-Thomson/Rokket-GSD/main/install.sh | bash

irm https://raw.githubusercontent.com/Kile-Thomson/Rokket-GSD/main/install.ps1 | iex

수동 설치 (Manual Install)

git clone https://github.com/Kile-Thomson/Rokket-GSD.git
cd Rokket-GSD
npm install
...

그 다음 VS Code를 다시 로드하세요 (Ctrl+Shift+P > "Developer: Reload Window").

[!TIP] 만약 code --install-extension이 조용히 성공했지만 확장 프로그램이 나타나지 않는다면, 수동으로 설치하세요: VS Code > Extensions > ...

메뉴 > "Install from VSIX..." > .vsix 파일을 선택하세요.

설치가 완료되면, 다음 단계에 따라 실행을 시작하세요:

아직 설치하지 않았다면, GSD 에이전트 (GSD agent)를 설치하고 인증하세요:

npm install -g gsd-pi
gsd

첫 실행 시 제공자 인증 (Anthropic, OpenAI, Google 등) 과정을 안내합니다. 확장 프로그램이 작동하려면 최소 하나 이상의 구성된 제공자가 필요합니다.

VS Code 활동 바 (Activity bar, 왼쪽 사이드바)에서 **로켓 아이콘 (rocket icon)**을 클릭하거나,
Ctrl+Shift+P를 누른 후 **"Rokket GSD: Open"**을 선택하세요.

확장 프로그램이 자동으로 gsd 프로세스를 생성합니다. 모든 설정이 올바르게 완료되었다면, 빠른 작업 칩 (quick-action chips)이 포함된 환영 화면이 나타납니다.

설정이 잘못된 경우, 확장 프로그램이 **시작 시 상태 점검 (health check on startup)**을 수행하고 구체적인 수정 지침이 담긴 알림을 표시합니다. 또한 채팅에서 /gsd doctor를 실행하여 문제를 진단할 수 있습니다.

음성 메시지 지원이 가능한 Telegram 그룹으로 대화를 전달하려면:

봇 생성 — Telegram에서 @BotFather에게 메시지를 보내 /newbot을 입력하고, 토큰 (token)을 복사하세요.
봇 추가 — 해당 봇을 귀하의 Telegram 그룹에 추가하고 관리자 (admin)로 지정하세요.
설정 마법사 실행 — Rokket GSD 채팅에서 /telegram을 입력하거나 Ctrl+Shift+P → **"Rokket GSD: Telegram Setup"**을 사용하세요.
봇 토큰 붙여넣기 — 요청 시 토큰을 붙여넣으면 마법사가 그룹을 자동으로 감지하고 연결을 확인합니다.
(선택 사항) 음성 전사 (voice transcription) 활성화 — /telegram voice를 실행하고 Whisper를 위한 OpenAI API 키를 입력하세요.

모든 자격 증명 (credentials)은 VS Code의 SecretStorage에 안전하게 저장되며, 설정 파일이나 소스 코드에는 절대 저장되지 않습니다.

VS Code 설정 (Ctrl+,)을 열고 "gsd"를 검색하여 다음 항목을 구성할 수 있습니다:

테마 (Theme) — Classic, Phosphor, Clarity 또는 Forge 중에서 선택
전송 키 (Send key) — 줄바꿈을 위해 Enter를 사용하는 것을 선호한다면 Ctrl+Enter로 전환
레이아웃 (Layout) — 사이드바 패널 (sidebar panel) 또는 에디터 탭 (editor tab)으로 열기
자동 업데이트 (Auto-updates) — 기본적으로 활성화되어 있으며, GitHub Releases를 확인합니다.

이전 세션 탐색 (Browse previous sessions) — 제목, 날짜, 메시지 개수를 보여주는 검색 가능한 패널을 사용합니다.
모든 세션 재개 (Resume any session) — 클릭 한 번으로 재개하며, 로드 시 전체 컨텍스트 (Context)와 대화 상태 (Conversation state)가 주입됩니다.
웰컴 스크린에서 재개 (Resume from welcome screen) — "↩ Resume" 칩 또는 /resume 슬래시 명령 (Slash command)을 사용합니다.
세션 이름 변경 (Rename sessions) — 나중에 쉽게 찾을 수 있도록 의미 있는 이름으로 변경합니다.
세션 삭제 (Delete sessions) — 오래된 대화를 정리합니다.
각 세션은 고유한 GSD 프로세스를 가집니다 — 상태 (State)가 완전히 격리됩니다.

/를 입력하여 59개 이상의 명령어가 포함된 커맨드 팔레트 (Command palette)를 엽니다:

GSD 워크플로 (GSD Workflow) (46개 명령어)

명령어	기능
`/gsd`	컨텍스트 위저드 (Contextual wizard) — 다음 동작을 선택합니다
`/gsd auto`	작업 자동 실행 (작업마다 새로운 컨텍스트 적용)
`/gsd next`	다음 작업 실행
`/gsd stop`	자동 모드 (Auto-mode) 중지
`/gsd pause`	자동 모드 일시 중지 (상태 유지)
`/gsd quick`	GSD 보장 하에 즉석 작업 (Ad-hoc task) 실행
`/gsd discuss`	실행 없이 논의만 진행
`/gsd status`	프로젝트 대시보드 — 마일스톤 (Milestones), 슬라이스 (Slices), 작업 (Tasks)
`/gsd visualize`	워크플로 시각화 오버레이 (Workflow visualizer overlay) 열기
`/gsd help`	카테고리별 명령어 참조
`/gsd changelog`	카테고리별 릴리스 노트 (Release notes) 표시
`/gsd capture`	자동 모드 중에 생각(Thought)을 캡처
`/gsd steer`	자동 모드의 우선순위 재지정
`/gsd triage`	대기 중인 캡처 항목의 트리아지 (Triage)를 수동으로 트리거
`/gsd knowledge`	프로젝트 지식 베이스 (Knowledge base) 조회 또는 추가
`/gsd queue`	향후 마일스톤을 큐 (Queue)에 추가 및 순서 변경
`/gsd new-milestone`	사양서 (Specification document)로부터 마일스톤 생성
`/gsd park`	마일스톤 보관 (Park) — 삭제하지 않고 건너뜀
`/gsd unpark`	보관된 마일스톤 재활성화
`/gsd dispatch`	특정 단계 (Phase)를 직접 배정 (Dispatch)
`/gsd history`	실행 이력 조회
`/gsd undo`	마지막으로 완료된 단위 (Unit) 되돌리기
`/gsd skip`	자동 모드 배정에서 특정 단위를 제외
`/gsd start`	워크플로 템플릿 시작 (버그 수정, 스파이크, 기능 구현 등)
`/gsd templates`	사용 가능한 워크플로 템플릿 목록 표시
`/gsd export`	마일스톤 보고서를 HTML로 내보내기
`/gsd cleanup`

내장 액션 (Built-in Actions) (13개 명령어)

명령 (Command)	기능
`/compact`	토큰 사용량을 줄이기 위해 컨텍스트(Context) 압축
`/export`	대화를 HTML로 내보내기
`/model`	모델 선택기 열기
`/thinking`	사고 단계(Thinking level) 순환
`/new`	새로운 대화 시작
`/history`	세션 탐색 및 전환
`/copy`	마지막 어시스턴트 메시지 복사
`/resume`	마지막 세션 재개
`/auto-compact`	자동 압축(Auto-compaction) 기능 켜기/끄기
`/auto-retry`	일시적 오류 발생 시 자동 재시도(Auto-retry) 기능 켜기/끄기
`/telegram`	Telegram 스트리밍 시작 — 설정을 열고 연결함
`/telegram-stop`	Telegram 스트리밍 중단 — 릴레이(Relay)를 종료하고 연결을 끊음
`/telegram voice`	음성 전사(Voice transcription)를 위한 OpenAI API 키 설정

모델 선택기 (Model picker)
섹션 헤더를 통해 제공자(Provider)별로 그룹화되어 있으며, 컨텍스트 윈도우(Context window) 크기 및 추론 능력(Reasoning capability) 태그를 포함합니다.

사고 수준 드롭다운 (Thinking level dropdown)
off / minimal / low / medium / high / xhigh 옵션과 각 수준에 대한 설명을 제공합니다.

모델 인식 사고 (Model-aware thinking)
사용 중인 모델이 지원하지 않는 수준은 숨깁니다. 확장된 사고(Extended thinking)는 이를 처리할 수 있는 모델에 대해서만 표시됩니다.

컨텍스트 사용량 바 (Context usage bar)
헤더 아래에 위치하며 색상별 임계값(0-70% 녹색, 70-90% 황색, 90% 이상 적색)을 표시합니다.

실시간 세션 통계 (Live session stats)
토큰 수(Token count), 세션 비용(Session cost), 컨텍스트 압박(Context pressure)을 한눈에 보여줍니다.

동적 모델 라우팅 인디케이터 (Dynamic model routing indicator)
gsd-pi가 작업 도중 모델을 전환할 때 모델 배지가 깜빡이며 토스트(Toast) 메시지로 알림을 보냅니다.

순차적 세그먼트 렌더링 (Sequential segment rendering)
텍스트, 사고 블록(Thinking blocks), 도구 호출(Tool calls)이 재렌더링이나 레이아웃 점프 없이 도착 순서대로 스트리밍됩니다.

전체 마크다운 (Full markdown)
구문 강조(Syntax-highlighted)가 적용된 코드 블록, 표(Tables), 인용구(Blockquotes), 헤딩(Headings), 인라인 코드(Inline code) 및 이미지를 지원합니다.

복사 버튼 (Copy buttons)
모든 코드 블록과 어시스턴트의 전체 응답에 포함되어 있습니다.

이미지 붙여넣기 및 드래그 앤 드롭 (Image paste and drag-drop)
입력 영역에 직접 이미지를 붙여넣거나 끌어다 놓을 수 있습니다.

파일 첨부 (File attachments)
버튼, 드래그 앤 드롭 또는 붙여넣기를 통해 가능하며, 파일 유형별 아이콘과 제거 가능한 칩(Chips)이 제공됩니다.

메시지 타임스탬프 (Message timestamps)
실시간으로 업데이트되는 상대적 시간과 마우스 호버 시 표시되는 절대 시간을 제공합니다.

사고 블록 (Thinking blocks)
기본적으로 접혀 있으며 줄 수(Line count) 표시기가 나타나고, 스트리밍 중에는 확장됩니다.

스트리밍 중 조종 (Steer while streaming)
작업을 중단하지 않고 작업 도중에 에이전트(Agent)의 방향을 재지정할 수 있습니다.

조종 지속성 (Steer persistence)
자동 모드(Auto-mode) 중에 전송된 메시지는 OVERRIDES.md에 저장되어 현재 턴뿐만 아니라 향후 모든 작업에 적용됩니다.

입력 영역 드래그 크기 조절 (Drag-to-resize input area)
긴 메시지를 위해 입력 영역의 크기를 조절할 수 있습니다.

에이전트 없이 직접 bash 명령어를 실행할 수 있는 !command 단축키

실시간 도구 호출 (Live tool calls): 40개 이상의 도구에 대해 카테고리별 아이콘과 색상 강조 적용
풍부한 주요 인자 (Key arg) 표시: lsp, browser_, github_, gsd_*, mcp_call, bash 등을 포함한 다양한 인자 표시
접이식 출력 (Collapsible output): 대량의 결과에 대해 스마트한 생략 (Truncation) 기능 제공
병렬 도구 표시기 (Parallel tool indicator): 도구가 동시에 실행될 때 ⚡ 배지와 펄스 애니메이션 표시
도구 호출 그룹화 (Tool call grouping): 연속된 읽기 전용 도구(파일 읽기, 검색, 브라우저 읽기)를 확장 가능한 요약 행으로 축소
서브에이전트 (Subagent) 결과: 토큰 및 비용 내역을 보여주는 사용량 필(Pills)과 함께 전체 마크다운 (Markdown)으로 렌더링
클릭 가능한 파일 경로: VS Code에서 직접 열 수 있는 경로 제공
쉬머 애니메이션 (Shimmer animation): 실행 중인 도구에 적용되어 현재 활성화된 상태를 항상 확인 가능
소요 시간 추적 (Duration tracking): 완료된 모든 도구 호출에 대해 시간 기록
서버 측 도구 표시기 (Server-side tool indicators): Anthropic의 네이티브 서버 측 도구(웹 검색, 코드 실행)를 위한 컴팩트한 인라인 카드 — 도구 이름, 검색 쿼리, 실행 중 스피너, 완료 시 결과 개수 표시

실시간 진행 상황 위젯 (Live progress widget): 입력창 상단에 고정되어 현재 작업, 단계, 진행률 표시줄, 경과 시간, 비용 및 활성 모델 표시
단계 렌더링 (Phase rendering): 실행 중 (Executing), 계획 중 (Planning), 검증 중 (Validating, ✓), 완료 중 (Completing), 차단됨 (Blocked), 재계획 중 (Replanning) 등 고유한 라벨과 아이콘 제공
토론 일시 중지 가시성 (Discussion-pause visibility): 자동 모드 (Auto-mode)가 슬라이스 토론을 위해 일시 중지될 때 💬 "토론 대기 중 (Awaiting Discussion)" 문구와 /gsd discuss 힌트 표시
대기 중인 캡처 배지 (Pending captures badge, 📌): 분류를 기다리는 /gsd capture 생각을 진행 상황 위젯에 표시
워크플로 상태 배지 (Workflow state badge): 헤더에 활성 마일스톤 (Milestone), 슬라이스 (Slice), 작업 (Task) 및 현재 단계를 표시
자동 모드 표시기 (Auto-mode indicator): ⚡ 자동 (Auto), ▸ 다음 (Next), ⏸ 일시 중지 (Paused) 상태 표시
상태 위젯 (Health widget): 푸터 (Footer)에 상주하는 시스템 상태 표시줄로 시스템 상태, 예산, 제공자 문제 및 환경 오류 표시
모델 상태 표시기 (Model health indicator): 모델 이름 옆에 현재 시스템 상태를 반영하는 녹색/황색/적색 점 표시

Worker cards (워커 카드): 병렬 자동 모드 (parallel auto-mode) 동안 각 워커별 마일스톤 ID (milestone ID), 상태 배지 (state badge), 현재 단위 (current unit) 및 비용을 표시

State badges (상태 배지): 실행 중 (Running), 일시 중지 (Paused), 중지 (Stopped), 오류 (Error) 상태를 각각의 색상으로 구분하여 표시

Budget usage bars (예산 사용량 바): 워커별로 표시되며 80%와 100% 지점에서 녹색/황색/적색 임계값 (thresholds) 적용

Budget alert toast (예산 경고 토스트): 어떤 워커라도 budget_ceiling의 80%를 초과하면 VS Code 경고를 발생시킴

Stale worker detection (오래된 워커 감지): 하트비트 (heartbeat)가 오래된 워커를 흐리게 처리하고 "(stale)" 라벨을 표시

Graceful degradation (우아한 성능 저하): 병렬 데이터가 존재하지 않을 경우 표준 단일 워커 (single-worker) 디스플레이로 전환

Full-page overlay (전체 페이지 오버레이): /gsd visualize 명령어를 통해 실행하며 세 개의 탭으로 구성

Progress tab (진행 탭): 마일스톤 헤더, 진행률 바 (progress bars), 슬라이스/태스크 세부 정보 (slice/task breakdown), 마일스톤 레지스트리 (milestone registry), 차단 요소 (blockers) 및 다음 작업 (next action) 포함
Metrics tab (메트릭 탭): 비용 세부 정보 (cost breakdown), 도구 호출 횟수 (tool call counts), 모델 사용량 (model usage), 토큰 세부 정보 (token breakdown) 및 컨텍스트 사용량 (context usage) 포함
Health tab (상태 탭): 시스템 상태 (system health status), 예산 정보 (budget info), 환경 경고 (environment warnings) 및 활성 모델 (active model) 포함

Auto-refresh (자동 새로고침): 활성 자동 모드 (active auto-mode) 동안 5초마다 실행

Dashboard panel (대시보드 패널): 마일스톤 레지스트리 (milestone registry), 슬라이스/태스크 진행 상황 (slice/task progress), 비용 예측 (cost projections) 및 활동 로그 (activity log) 포함

Kile-Thomson/Rokket-GSD

요약

핵심 포인트

댓글