에이전트 기반 SAST. 화이트박스. CI 준비 완료.
agentgg는 에이전트 기반의 SAST (Static Application Security Testing) 스캐너입니다. 이 스캐너의 에이전트들은 코드를 읽고 추론합니다. 전통적인 SAST가 패턴 매칭을 하는 방식과 달리, agentgg는 임포트를 따라가고 호출 그래프(call graph)를 확인하며 발견된 취약점을 보고하기 전에 검증합니다. 전체 리포지토리 또는 pull request 리뷰를 위한 git diff에 대해 실행할 수 있습니다. 모든 스캔은 프로젝트에 대한 개요를 에이전트들에게 브리핑하는 빠른 재구성(recon) 패스로 시작하며, 중단된 스캔은 다시 실행 시 이어서 진행됩니다.
문서화 · agentgg.dev · 플랫폼 · 에이전트 카탈로그 · 버그 신고 · 보안 문제 신고
GitHub에서 성장하고 스타를 달아주세요! ⭐️
agentgg는 베타 버전입니다. 변화가 있을 수 있고 경계 부분이 거칠 수 있습니다. 버그 보고와 피드백은 언제나 환영합니다. 이슈를 열어주세요.
로컬 환경에서 실행하고 싶지 않으신가요? app.agentgg.dev에서는 호스팅 서비스와 동일한 스캐너를 운영합니다: 리포지토리를 업로드하기만 하면 되며, 설치 과정이나 자체 제공자 키(provider key)가 필요 없습니다.
npm install -g agentgg
Node.js 20 이상이 필요합니다. 또한 Anthropic, OpenAI, AWS Bedrock, Google Vertex AI, OpenRouter 또는 로컬 Ollama와 같은 모델 제공자 계정이 필요합니다. 설정 방법은 Providers를 참조하고, 소스에서 빌드하려면 CONTRIBUTING.md를 참고하세요.
agentgg init # 일회성: 제공자를 선택하고 키 붙여넣기
agentgg scan ./src -o ./out # 모든 것 스캔
agentgg scan ./src --diff origin/main...HEAD -o ./out # PR 스타일: 변경된 부분만 스캔
...
스캔은 ./out/에 summary.md와 발견된 취약점별 마크다운 파일 하나를 작성하며, 재개(resume), 상태(status), 그리고 재검증(revalidate) 기능을 수행하는 state/ 디렉토리를 만듭니다. 동일한 -o 옵션과 변경되지 않은 파일을 사용하여 다시 실행하면 건너뛰고; 다른 -o 옵션을 사용하면 새로 시작합니다.
워크스루: 빠른 시작.
전체 문서는 docs.agentgg.dev에서 찾아보세요.
- Quickstart: 첫 번째 스캔 방법
- 스캔 작동 방식: 단계와 기본값
- 제공자(Providers): 모델 제공자 설정하기
- 스캔 플래그: 전체 플래그 참조
- 문제 해결: 무언가 잘못되었을 때
에이전트는 마크다운 파일 하나로 구성됩니다: 어디를 볼지 선언하는 YAML 프론트매터와 이 에이전트를 이 리포지토리에서 실행할 가치가 있는지 결정하는 선택적 사전 조건(precondition), 그리고 프롬프트가 되는 마크다운 본문으로 이루어져 있습니다. where 부분에 extensions나 filePatterns를 선언하지 않은 에이전트는 파일 범위가 없습니다: 미리 선택된 파일을 받지 않고 자체 도구를 사용하여 전체 리포지토리를 검색합니다. 카탈로그는 첫 스캔 시 agentgg-dev/agentgg-agents에서 자동 다운로드되며, agentgg create는 과거의 인시던트 보고서를 재사용 가능한 에이전트로 변환합니다.
직접 작성하기: Agent anatomy · Targeting · Create from reports
버그 보고서, 에이전트, 그리고 풀 리퀘스트 모두 환영합니다. 개발 워크플로우는 CONTRIBUTING.md를, 커뮤니티 기대 사항은 CODE_OF_CONDUCT.md를, 취약점을 비공개로 신고하려면 SECURITY.md를 참고하세요.
agentgg는 Apache License, Version 2.0에 따라 라이선스가 부여되었습니다. 전체 텍스트는 LICENSE에서, 출처 표시는 NOTICE에서 확인하십시오.