Files
gravity_control/.agents/references/tech-stack.md
Variet Worker 5f795b9a91 refactor(extension): 모듈 분리 + Hub 통합 테스트 #task-395
- extension.ts 3,446→1,289줄 (-63%)
- step-probe.ts (1,435줄): setupMonitor, processResponseFile, tryApprovalStrategies
- observer-script.ts (687줄): DOM observer script
- ws-client.ts (390줄): WSBridgeClient
- step-utils.ts (114줄): step 파싱 유틸
- auth.py (115줄): JWT + registration code
- hub.py (581줄): WSHub + per-client queue
- Hub WS 연동 테스트 통과 (auth, chat, register)
- VSIX v0.4.0 빌드
2026-03-17 06:41:42 +09:00

1.9 KiB

Tech Stack

AI 에이전트는 구현 전 이 문서를 확인하여 올바른 기술/버전을 사용합니다.

언어 & 런타임

항목 버전 경로/비고
Python 3.x (miniforge3) C:\ProgramData\miniforge3\envs\gravity_control\python.exe
Node.js 시스템 설치 node, npm (PowerShell에서 cmd /c npm 권장)
TypeScript (Extension) extension/src/extension.tstsc 빌드

Important

Python은 반드시 위 miniforge3 경로를 사용. WindowsApps의 python stub은 동작하지 않음.

프레임워크

항목 버전 용도
discord.py 2.x Discord 봇
watchdog - 파일시스템 감시
antigravity-sdk 로컬 VS Code Extension SDK 연동

패키지 관리

  • Python: pip (requirements.txt)
  • Extension: npm (extension/package.json)

개발 도구

도구 명령어
봇 실행 start_bot.bat 또는 C:\ProgramData\miniforge3\envs\gravity_control\python.exe main.py
Extension 빌드 cd extension && cmd /c npm run compile
Extension VSIX cd extension && cmd /c npx vsce package
봇 구문 검사 C:\ProgramData\miniforge3\envs\gravity_control\python.exe -c "import bot, bridge, config, main"

환경 변수

변수명 용도 기본값
DISCORD_TOKEN Discord 봇 토큰 (필수)
DISCORD_GUILD_ID Discord 서버 ID (필수)
BRAIN_PATH AG 브레인 경로 ~/.gemini/antigravity/brain
BOT_MODE 봇 모드 (local/remote/gateway) local
REMOTE_BRIDGE_URL 원격 브릿지 URL (remote 모드 전용)
GATEWAY_API_KEY Gateway REST API 인증 키 (gateway 모드)
GRAVITY_HUB_SECRET WS Hub JWT 서명 시크릿 (자동생성 가능)
GRAVITY_REGISTRATION_CODE Extension 등록 코드 (미설정 시 인증 생략)