Metadata-Version: 2.4
Name: gitsentry
Version: 0.1.0
Summary: GitHub security audit CLI for LLM-assisted development environments
Project-URL: Homepage, https://github.com/beret21/GitSentry
Project-URL: Repository, https://github.com/beret21/GitSentry
Project-URL: Issues, https://github.com/beret21/GitSentry/issues
Author-email: Yoonseok Jang <beret21@gmail.com>
License: MIT
Keywords: audit,claude,cli,github,llm,security
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Security
Requires-Python: >=3.11
Requires-Dist: anthropic>=0.40.0
Requires-Dist: gitpython>=3.1
Requires-Dist: pydantic>=2.0
Requires-Dist: pygithub>=2.0
Requires-Dist: python-dotenv>=1.0
Requires-Dist: rich>=13.0
Requires-Dist: typer>=0.12
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Description-Content-Type: text/markdown

# GitSentry

LLM 개발 환경(Claude Code, Codex 등)에서 GitHub push 전 보안 감사 CLI 도구.

## 기능

| 명령 | 설명 |
|------|------|
| `gitsentry audit .` | 현재 저장소 공개 파일 보안 감사 |
| `gitsentry history .` | Git 커밋 히스토리 보안 감사 |
| `gitsentry scan --all` | 계정 전체 GitHub 저장소 감사 |
| `gitsentry preview .` | Push 대상 vs 제외 파일 시각화 |
| `gitsentry pre-push` | Pre-push 훅 수동 실행 |
| `gitsentry generate-skill` | Claude Code 보안 감사 스킬 생성 |

## 설치

```bash
# pipx 권장 (전역 설치, 가상환경 불필요)
pipx install git+https://github.com/beret21/GitSentry.git

# 업데이트
pipx upgrade gitsentry
```

pipx가 없다면:

```bash
brew install pipx
pipx ensurepath
```

개발용 설치:

```bash
git clone https://github.com/beret21/GitSentry.git
cd GitSentry
pip install -e ".[dev]"
```

## 빠른 시작

```bash
# 현재 저장소 감사
gitsentry audit .

# Push 전 미리보기
gitsentry preview .

# pre-push 훅 설치
./scripts/install-hook.sh .
```

## 환경 변수 (.env)

```
GITHUB_TOKEN=ghp_your_token    # 원격 저장소 감사에 필요
ANTHROPIC_API_KEY=sk-ant-...   # --llm 옵션 사용 시 필요
```

## 탐지 패턴

**DANGER (push 차단):** API 키(`sk-`, `ghp_`, `AKIA`), 비밀번호, Bearer 토큰

**WARNING (주의):** LLM 내부 문서 (CLAUDE.md, LESSONS_LEARNED.md, DEVELOPMENT.md)
