astro:gate — 게이트 규칙 편집기
ai-gate/ (SQLite + 웹 UI) 미니 앱을 브라우저에서 열어 게이트가 금지 명령어를 차단하는 데 사용하는 규칙을 편집합니다. astro:setup(게이트 설치)의 편집 가능한 대응 요소입니다.
1단계 — 게이트가 설치되어 있는지 확인
- 프로젝트 루트에
ai-gate/app.py가 존재해야 합니다. 없으면astro:setup을 먼저 실행하세요 (ai-gate/를 설치하고 게이트를 생성합니다).
2단계 — 앱 실행
- **
python3 ai-gate/app.py**를 실행합니다 (기본 포트 8787, 포트가 사용 중이면--port N사용). 서버는 로컬(127.0.0.1)에서 실행되며, 세션을 차단하지 않도록 백그라운드에서 실행하세요. - 브라우저에서 **
http://127.0.0.1:8787**을 엽니다 (환경에 내장 브라우저가 있으면 거기서 열고, 없으면 URL을 사용자에게 전달하세요).
3단계 — 편집 및 생성
- UI에서 규칙을 추가/편집/비활성화/제거합니다 (정규식 또는 리터럴 텍스트).
- 게이트 생성 버튼을 클릭하면 활성 규칙으로
.claude/hooks/astro_gate.py를 다시 작성합니다. SQLite (ai-gate/rules.db)가 진실의 원천이며, 스크립트는 생성된 결과물이므로 수동으로 편집하지 마세요. - 작업이 끝나면 서버를 중지합니다 (Ctrl+C).
생성된
astro_gate.py는 독립 실행형(규칙이 내장됨)이므로 VM/CI에서도 CLI로 실행할 수 있습니다:python3 astro_gate.py "$CMD" && eval "$CMD"