commit-ai-agent 2.0.0 → 2.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +6 -15
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -12,9 +12,7 @@ Claude Code나 Codex 같은 CLI AI가 있는데 왜 commit-ai-agent를 써야
|
|
|
12
12
|
| ---- | :--------------------------: | :-------------: |
|
|
13
13
|
| 커밋 분석 | 수동 명령어 입력 필요 | **자동** (git commit 직후 백그라운드 실행) |
|
|
14
14
|
| 분석 범위 | 현재 세션 단일 프로젝트 | 현재 프로젝트 자동 분석 |
|
|
15
|
-
| 상시 실행 | 세션 종료 시 중단 | **데몬 서버** — 항상 켜져 있음 |
|
|
16
15
|
| Secret 탐지 | 없음 | **pre-push 훅** — push 전 자격증명 자동 차단 |
|
|
17
|
-
| 오프라인 큐 | 없음 | 서버 꺼진 동안 커밋 → 재시작 시 **자동 처리** |
|
|
18
16
|
| 분석 UI | 터미널 텍스트 | **브라우저 GUI** — 검색·필터·저장 |
|
|
19
17
|
| AI 비용 | 구독료 or API 종량제 | Google Gemini **무료 티어** 지원 |
|
|
20
18
|
| 개인화 | 없음 | 프로젝트별 리포트를 `reports/`에 **자동 저장** |
|
|
@@ -73,16 +71,12 @@ npm start 대신 Windows 사용자는 `start.bat`파일을 더블클릭하여
|
|
|
73
71
|
```env
|
|
74
72
|
GEMINI_API_KEY=여기에_API_키_입력 => 필수값
|
|
75
73
|
PORT=원하는 PORT 입력 (예: 3000, 50324 등) => 선택 사항(미설정 시 기본값 50324)
|
|
76
|
-
DEV_ROOT=C:/Users/projects => 선택 사항(미설정 시 현재 실행 디렉토리를 자동 사용)
|
|
77
74
|
```
|
|
78
75
|
|
|
79
|
-
| 변수 | 설명
|
|
80
|
-
| ---------------- |
|
|
81
|
-
| `GEMINI_API_KEY` | [Google AI Studio](https://aistudio.google.com/apikey)에서 발급 (무료)
|
|
82
|
-
| `
|
|
83
|
-
| `PORT` | (선택) 서버 포트 (기본값 50324) |
|
|
84
|
-
|
|
85
|
-
> Windows 경로는 `\` 대신 `/` 또는 `\\` 사용: `C:/dev`, `D:/projects`
|
|
76
|
+
| 변수 | 설명 |
|
|
77
|
+
| ---------------- | ---------------------------------------------------------------------- |
|
|
78
|
+
| `GEMINI_API_KEY` | [Google AI Studio](https://aistudio.google.com/apikey)에서 발급 (무료) |
|
|
79
|
+
| `PORT` | (선택) 서버 포트 (기본값 50324) |
|
|
86
80
|
|
|
87
81
|
---
|
|
88
82
|
|
|
@@ -197,9 +191,6 @@ SKIP_SECRET_SCAN=1 git push
|
|
|
197
191
|
**429 오류 (할당량 초과)**
|
|
198
192
|
→ Gemini 무료 티어 한도 도달. 잠시 후 재시도하거나 [유료 플랜](https://ai.google.dev)으로 업그레이드하세요.
|
|
199
193
|
|
|
200
|
-
**프로젝트 목록이 안 뜸**
|
|
201
|
-
→ 기본값은 실행 디렉토리입니다. `DEV_ROOT` 환경변수로 프로젝트 경로를 직접 지정할 수 있습니다.
|
|
202
|
-
|
|
203
194
|
**`[DEP0190] DeprecationWarning` 경고 (Node.js 22+)**
|
|
204
195
|
→ `shell: true` 옵션과 args 배열을 함께 전달할 때 Node.js 22 이상에서 발생하는 보안 경고입니다. v1.0.7 이상으로 업데이트하면 해결됩니다.
|
|
205
196
|
|
|
@@ -237,7 +228,7 @@ npm install
|
|
|
237
228
|
|
|
238
229
|
# 3. 환경 설정
|
|
239
230
|
cp .env.example .env
|
|
240
|
-
# .env에 GEMINI_API_KEY 입력
|
|
231
|
+
# .env에 GEMINI_API_KEY 입력
|
|
241
232
|
|
|
242
233
|
# 4. 개발 서버 실행 (파일 변경 시 자동 재시작)
|
|
243
234
|
npm run dev
|
|
@@ -272,7 +263,7 @@ commit-ai-agent/
|
|
|
272
263
|
| `bin/cli.js` | npx 실행, hook 서브커맨드 (install / remove / status) |
|
|
273
264
|
| `src/server.js` | REST API + SSE 엔드포인트, 리포트 저장 |
|
|
274
265
|
| `src/analyzer.js` | Gemini API 호출, 모델 폴백(2.5→2.0→lite), 지수 백오프 |
|
|
275
|
-
| `src/git.js` |
|
|
266
|
+
| `src/git.js` | 커밋 diff, working status diff |
|
|
276
267
|
| `src/hooks/installer.js` | git hook 스크립트 설치·제거 (기존 hook 보존) |
|
|
277
268
|
| `src/hooks/post-commit.js`| 커밋 직후 서버 알림 (서버 없으면 조용히 종료) |
|
|
278
269
|
| `src/hooks/pre-push.js` | push 전 15가지 패턴으로 Secret 스캔, Gemini AI 오탐 필터링 |
|