agent-auto-approve 0.1.1__tar.gz
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.
- agent_auto_approve-0.1.1/LICENSE +21 -0
- agent_auto_approve-0.1.1/PKG-INFO +116 -0
- agent_auto_approve-0.1.1/README.md +104 -0
- agent_auto_approve-0.1.1/agent_auto_approve.egg-info/PKG-INFO +116 -0
- agent_auto_approve-0.1.1/agent_auto_approve.egg-info/SOURCES.txt +11 -0
- agent_auto_approve-0.1.1/agent_auto_approve.egg-info/dependency_links.txt +1 -0
- agent_auto_approve-0.1.1/agent_auto_approve.egg-info/entry_points.txt +2 -0
- agent_auto_approve-0.1.1/agent_auto_approve.egg-info/top_level.txt +1 -0
- agent_auto_approve-0.1.1/codex_approval_hook.py +1081 -0
- agent_auto_approve-0.1.1/pyproject.toml +3 -0
- agent_auto_approve-0.1.1/setup.cfg +23 -0
- agent_auto_approve-0.1.1/tests/test_approval_hook.py +298 -0
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 DongJinLee
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: agent-auto-approve
|
|
3
|
+
Version: 0.1.1
|
|
4
|
+
Summary: Manage approval hooks for Codex, Claude Code, and Antigravity CLI.
|
|
5
|
+
Home-page: https://github.com/jiind/agent-auto-approve
|
|
6
|
+
License: MIT
|
|
7
|
+
Project-URL: Issues, https://github.com/jiind/agent-auto-approve/issues
|
|
8
|
+
Requires-Python: >=3.8
|
|
9
|
+
Description-Content-Type: text/markdown
|
|
10
|
+
License-File: LICENSE
|
|
11
|
+
Dynamic: license-file
|
|
12
|
+
|
|
13
|
+
# Agent Auto Approve
|
|
14
|
+
|
|
15
|
+
`agent-auto-approve`는 Codex CLI, Claude Code, Antigravity CLI의 도구 승인 훅을 관리하는 Python CLI입니다. 프로젝트별 또는 전역으로 등록할 수 있습니다. Codex와 Claude Code는 새 세션 하나에 적용할 수도 있습니다.
|
|
16
|
+
|
|
17
|
+
## 빠른 시작
|
|
18
|
+
|
|
19
|
+
CLI는 Python 3.8 이상에서 실행됩니다. 아래 설치 예시에는 `uv`를 사용합니다. `launch`는 대상 에이전트의 CLI를 PATH에서 찾습니다. Windows에서 Claude Code 세션을 시작하려면 네이티브 `claude.exe`가 필요합니다. Claude Code 훅은 [`args`를 지원하는 2.1.139 이상](https://code.claude.com/docs/en/changelog)을 사용합니다.
|
|
20
|
+
|
|
21
|
+
`pyproject.toml`이 있는 이 저장소의 루트에서 CLI를 설치합니다.
|
|
22
|
+
|
|
23
|
+
```sh
|
|
24
|
+
git clone https://github.com/jiind/agent-auto-approve.git
|
|
25
|
+
cd agent-auto-approve
|
|
26
|
+
uv tool install .
|
|
27
|
+
agent-auto-approve --help
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
`install`과 `launch`에서 `--workspace-only`를 생략하면 훅에 전달되는 승인 요청에 작업 경로 제한이 적용되지 않습니다. 작업 디렉터리 안에서만 자동 승인하려면 아래 예시처럼 이 옵션을 붙입니다.
|
|
31
|
+
|
|
32
|
+
설정할 프로젝트의 루트로 이동합니다. `.codex` 디렉터리가 있는 프로젝트에서 다음 명령으로 작업 범위 제한을 켜고 훅을 등록한 뒤 확인할 수 있습니다.
|
|
33
|
+
|
|
34
|
+
```sh
|
|
35
|
+
agent-auto-approve install . --workspace-only
|
|
36
|
+
agent-auto-approve hooks .
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
새 Codex 세션 하나에서 써보려면 해당 프로젝트에서 다음 명령을 실행합니다.
|
|
40
|
+
|
|
41
|
+
```sh
|
|
42
|
+
agent-auto-approve launch --workspace-only
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
Claude Code는 `--claude`로 선택합니다. `.claude`가 있는 프로젝트 루트에서 아래 명령을 실행하면 작업 범위를 제한한 훅을 등록하고 확인할 수 있습니다.
|
|
46
|
+
|
|
47
|
+
```sh
|
|
48
|
+
agent-auto-approve install --claude . --workspace-only
|
|
49
|
+
agent-auto-approve hooks --claude .
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
Claude Code 세션 하나에만 적용하려면 `agent-auto-approve launch --claude --workspace-only`를 실행합니다.
|
|
53
|
+
|
|
54
|
+
Antigravity CLI는 `--agy`로 선택합니다. `.agents`가 있는 프로젝트 루트에서 훅을 등록하고 확인한 뒤 `agy`를 실행합니다. [Antigravity CLI 공식 문서](https://antigravity.google/docs/cli/reference/)
|
|
55
|
+
|
|
56
|
+
```sh
|
|
57
|
+
agent-auto-approve install --agy . --workspace-only
|
|
58
|
+
agent-auto-approve hooks --agy .
|
|
59
|
+
agy
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
## 명령
|
|
63
|
+
|
|
64
|
+
| 명령 | 동작 |
|
|
65
|
+
| --- | --- |
|
|
66
|
+
| `agent-auto-approve install [DIR] [--workspace-only]` | `DIR`을 지정하면 프로젝트에, 생략하면 사용자 전역에 훅을 등록합니다. 프로젝트에 대상 에이전트의 `.codex`, `.claude` 또는 `.agents`가 있어야 합니다. |
|
|
67
|
+
| `agent-auto-approve launch [--claude] [--workspace-only]` | 운영체제를 감지하고 훅을 적용한 새 세션을 시작합니다. Codex는 임시 훅 스크립트를, Claude Code는 임시 설정 파일을 사용하며 세션이 끝나면 해당 파일을 제거합니다. |
|
|
68
|
+
| `agent-auto-approve find [DIR] [--agy] [--claude] [--codex]` | `.agents`, `.claude`, `.codex` 디렉터리의 절대 경로를 한 줄에 하나씩 출력합니다. 옵션을 조합하면 선택한 디렉터리를, 생략하면 지원하는 디렉터리를 모두 찾습니다. |
|
|
69
|
+
| `agent-auto-approve hooks [DIR]` | 등록된 훅의 범위, 승인 모드, 설정 파일의 절대 경로를 출력합니다. |
|
|
70
|
+
| `agent-auto-approve uninstall [DIR] [--all]` | `DIR`을 지정하면 프로젝트의 훅을, 생략하면 전역 훅을 제거합니다. `--all`은 지정한 `DIR` 아래를 재귀 탐색하며, 이때 `DIR`을 생략하면 홈 아래를 탐색합니다. |
|
|
71
|
+
|
|
72
|
+
`install`, `hooks`, `uninstall`에는 `--agy`, `--claude`, `--codex` 중 하나를 지정할 수 있습니다. `launch`에는 `--claude` 또는 `--codex`를 지정할 수 있습니다. 이 명령들의 기본 대상은 Codex입니다.
|
|
73
|
+
|
|
74
|
+
| 대상 | 전역 등록 파일 | 프로젝트 등록 파일 |
|
|
75
|
+
| --- | --- | --- |
|
|
76
|
+
| Codex | `CODEX_HOME/hooks.json`, 기본 `~/.codex/hooks.json` | `DIR/.codex/hooks.json` |
|
|
77
|
+
| Claude Code | `CLAUDE_CONFIG_DIR/settings.json`, 기본 `~/.claude/settings.json` | `DIR/.claude/settings.local.json` |
|
|
78
|
+
| Antigravity CLI | `~/.gemini/config/hooks.json` | `DIR/.agents/hooks.json` |
|
|
79
|
+
|
|
80
|
+
Antigravity는 이 훅 설정 파일을 CLI, 앱, IDE에서 공통으로 읽습니다. [Antigravity 훅 설정 위치](https://antigravity.google/docs/hooks)
|
|
81
|
+
|
|
82
|
+
`find`와 `hooks`는 지정한 디렉터리와 그 하위를 탐색합니다. `DIR`을 생략하면 사용자 홈에서 시작합니다. 인자 없는 `hooks`는 홈 밖에 지정한 대상 에이전트의 전역 설정 디렉터리도 확인합니다. 접근할 수 없는 디렉터리는 건너뜁니다.
|
|
83
|
+
|
|
84
|
+
터미널에서는 진행 줄을 `디렉터리명...`으로 갱신하다가 대상을 찾으면 `디렉터리명... found`로 표시합니다. 색상을 지원하는 터미널에서는 `found`만 초록색입니다. 탐색이 끝나면 그 줄을 지우고 결과를 출력합니다.
|
|
85
|
+
|
|
86
|
+
`agent-auto-approve --help`로 명령 목록을 확인하고, `agent-auto-approve find --help`처럼 명령 뒤에 `--help`를 붙여 해당 명령의 인자와 옵션을 확인할 수 있습니다. `-h`도 사용할 수 있습니다.
|
|
87
|
+
|
|
88
|
+
## 자동 승인 범위
|
|
89
|
+
|
|
90
|
+
기본 모드는 훅에 전달된 도구 승인 요청을 자동 승인합니다. 사용자의 답변이 필요한 Claude Code와 Antigravity의 질문은 기존 흐름을 따릅니다. `--workspace-only`를 붙이면 대상 경로와 해당하는 경우 명령 실행 위치가 아래 기준 안에 있다고 확인된 경우에만 자동 승인합니다.
|
|
91
|
+
|
|
92
|
+
| 설정 방법 | 기준 디렉터리 |
|
|
93
|
+
| --- | --- |
|
|
94
|
+
| `agent-auto-approve install --workspace-only` | Codex는 세션의 작업 디렉터리, Claude Code는 세션이 시작된 프로젝트 루트, Antigravity는 훅의 `workspacePaths`에 전달된 작업 디렉터리를 사용합니다. |
|
|
95
|
+
| `agent-auto-approve install DIR --workspace-only` | 지정한 프로젝트 루트 `DIR` |
|
|
96
|
+
| `agent-auto-approve launch --workspace-only` | `launch`를 실행한 디렉터리 |
|
|
97
|
+
|
|
98
|
+
경로 판별은 단순한 POSIX `touch`·`mkdir` 명령, Codex의 명시적인 파일시스템 권한 요청, Claude Code와 Antigravity의 절대 경로를 지정한 기본 파일 도구를 지원합니다. Antigravity는 파일 읽기·생성·편집과 디렉터리 목록의 명시적 경로를 확인합니다. Antigravity 명령 요청에 실행 디렉터리(`Cwd`)가 없으면 명령의 대상 경로가 절대 경로일 때만 확인합니다. 작업 범위 밖의 경로나 확인하기 어려운 요청은 각 에이전트의 기존 승인 절차로 넘어갑니다. 예를 들어 `~/work/test`가 기준일 때 `touch ~/note.txt`는 홈 디렉터리에 파일을 생성하므로 기존 승인 절차를 따릅니다.
|
|
99
|
+
|
|
100
|
+
Claude Code의 명시적인 거부 규칙, 관리형 훅 설정, 작업 공간 신뢰 정책은 계속 적용됩니다. 네트워크 샌드박스 승인 창은 별도 경로로 처리됩니다. 전역 훅과 프로젝트 훅을 함께 설치하면 두 등록이 함께 적용될 수 있으므로, 작업 범위 제한이 필요하면 적용되는 등록의 모드를 확인합니다. [Claude Code 훅 문서](https://code.claude.com/docs/en/hooks#permissionrequest)
|
|
101
|
+
|
|
102
|
+
같은 에이전트에 이 도구의 전역 훅이 등록돼 있으면 프로젝트 `install DIR` 또는 `launch` 전에 전역 설정 경로와 승인 모드를 경고하고 계속할지 묻습니다. `y`를 입력하면 진행하고, `n`이나 빈 입력이면 중단합니다.
|
|
103
|
+
|
|
104
|
+
## 제거
|
|
105
|
+
|
|
106
|
+
프로젝트 루트에서 `agent-auto-approve uninstall .`을 실행하면 해당 프로젝트의 등록을 제거합니다. 전역 등록은 `agent-auto-approve uninstall`로 제거할 수 있으며, 홈 밖에 설정한 전역 등록도 이 명령에 해당합니다. Claude Code는 `--claude`, Antigravity는 `--agy`를 붙입니다. 이 도구가 제거하는 범위는 자신이 등록한 훅입니다.
|
|
107
|
+
|
|
108
|
+
등록된 훅을 제거한 뒤 다음 명령으로 CLI를 제거할 수 있습니다.
|
|
109
|
+
|
|
110
|
+
```sh
|
|
111
|
+
uv tool uninstall agent-auto-approve
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
## 패키지 빌드
|
|
115
|
+
|
|
116
|
+
저장소 루트에서 `uv build`를 실행하면 `dist/`에 wheel과 소스 배포 파일이 생성됩니다.
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
# Agent Auto Approve
|
|
2
|
+
|
|
3
|
+
`agent-auto-approve`는 Codex CLI, Claude Code, Antigravity CLI의 도구 승인 훅을 관리하는 Python CLI입니다. 프로젝트별 또는 전역으로 등록할 수 있습니다. Codex와 Claude Code는 새 세션 하나에 적용할 수도 있습니다.
|
|
4
|
+
|
|
5
|
+
## 빠른 시작
|
|
6
|
+
|
|
7
|
+
CLI는 Python 3.8 이상에서 실행됩니다. 아래 설치 예시에는 `uv`를 사용합니다. `launch`는 대상 에이전트의 CLI를 PATH에서 찾습니다. Windows에서 Claude Code 세션을 시작하려면 네이티브 `claude.exe`가 필요합니다. Claude Code 훅은 [`args`를 지원하는 2.1.139 이상](https://code.claude.com/docs/en/changelog)을 사용합니다.
|
|
8
|
+
|
|
9
|
+
`pyproject.toml`이 있는 이 저장소의 루트에서 CLI를 설치합니다.
|
|
10
|
+
|
|
11
|
+
```sh
|
|
12
|
+
git clone https://github.com/jiind/agent-auto-approve.git
|
|
13
|
+
cd agent-auto-approve
|
|
14
|
+
uv tool install .
|
|
15
|
+
agent-auto-approve --help
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
`install`과 `launch`에서 `--workspace-only`를 생략하면 훅에 전달되는 승인 요청에 작업 경로 제한이 적용되지 않습니다. 작업 디렉터리 안에서만 자동 승인하려면 아래 예시처럼 이 옵션을 붙입니다.
|
|
19
|
+
|
|
20
|
+
설정할 프로젝트의 루트로 이동합니다. `.codex` 디렉터리가 있는 프로젝트에서 다음 명령으로 작업 범위 제한을 켜고 훅을 등록한 뒤 확인할 수 있습니다.
|
|
21
|
+
|
|
22
|
+
```sh
|
|
23
|
+
agent-auto-approve install . --workspace-only
|
|
24
|
+
agent-auto-approve hooks .
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
새 Codex 세션 하나에서 써보려면 해당 프로젝트에서 다음 명령을 실행합니다.
|
|
28
|
+
|
|
29
|
+
```sh
|
|
30
|
+
agent-auto-approve launch --workspace-only
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
Claude Code는 `--claude`로 선택합니다. `.claude`가 있는 프로젝트 루트에서 아래 명령을 실행하면 작업 범위를 제한한 훅을 등록하고 확인할 수 있습니다.
|
|
34
|
+
|
|
35
|
+
```sh
|
|
36
|
+
agent-auto-approve install --claude . --workspace-only
|
|
37
|
+
agent-auto-approve hooks --claude .
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
Claude Code 세션 하나에만 적용하려면 `agent-auto-approve launch --claude --workspace-only`를 실행합니다.
|
|
41
|
+
|
|
42
|
+
Antigravity CLI는 `--agy`로 선택합니다. `.agents`가 있는 프로젝트 루트에서 훅을 등록하고 확인한 뒤 `agy`를 실행합니다. [Antigravity CLI 공식 문서](https://antigravity.google/docs/cli/reference/)
|
|
43
|
+
|
|
44
|
+
```sh
|
|
45
|
+
agent-auto-approve install --agy . --workspace-only
|
|
46
|
+
agent-auto-approve hooks --agy .
|
|
47
|
+
agy
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
## 명령
|
|
51
|
+
|
|
52
|
+
| 명령 | 동작 |
|
|
53
|
+
| --- | --- |
|
|
54
|
+
| `agent-auto-approve install [DIR] [--workspace-only]` | `DIR`을 지정하면 프로젝트에, 생략하면 사용자 전역에 훅을 등록합니다. 프로젝트에 대상 에이전트의 `.codex`, `.claude` 또는 `.agents`가 있어야 합니다. |
|
|
55
|
+
| `agent-auto-approve launch [--claude] [--workspace-only]` | 운영체제를 감지하고 훅을 적용한 새 세션을 시작합니다. Codex는 임시 훅 스크립트를, Claude Code는 임시 설정 파일을 사용하며 세션이 끝나면 해당 파일을 제거합니다. |
|
|
56
|
+
| `agent-auto-approve find [DIR] [--agy] [--claude] [--codex]` | `.agents`, `.claude`, `.codex` 디렉터리의 절대 경로를 한 줄에 하나씩 출력합니다. 옵션을 조합하면 선택한 디렉터리를, 생략하면 지원하는 디렉터리를 모두 찾습니다. |
|
|
57
|
+
| `agent-auto-approve hooks [DIR]` | 등록된 훅의 범위, 승인 모드, 설정 파일의 절대 경로를 출력합니다. |
|
|
58
|
+
| `agent-auto-approve uninstall [DIR] [--all]` | `DIR`을 지정하면 프로젝트의 훅을, 생략하면 전역 훅을 제거합니다. `--all`은 지정한 `DIR` 아래를 재귀 탐색하며, 이때 `DIR`을 생략하면 홈 아래를 탐색합니다. |
|
|
59
|
+
|
|
60
|
+
`install`, `hooks`, `uninstall`에는 `--agy`, `--claude`, `--codex` 중 하나를 지정할 수 있습니다. `launch`에는 `--claude` 또는 `--codex`를 지정할 수 있습니다. 이 명령들의 기본 대상은 Codex입니다.
|
|
61
|
+
|
|
62
|
+
| 대상 | 전역 등록 파일 | 프로젝트 등록 파일 |
|
|
63
|
+
| --- | --- | --- |
|
|
64
|
+
| Codex | `CODEX_HOME/hooks.json`, 기본 `~/.codex/hooks.json` | `DIR/.codex/hooks.json` |
|
|
65
|
+
| Claude Code | `CLAUDE_CONFIG_DIR/settings.json`, 기본 `~/.claude/settings.json` | `DIR/.claude/settings.local.json` |
|
|
66
|
+
| Antigravity CLI | `~/.gemini/config/hooks.json` | `DIR/.agents/hooks.json` |
|
|
67
|
+
|
|
68
|
+
Antigravity는 이 훅 설정 파일을 CLI, 앱, IDE에서 공통으로 읽습니다. [Antigravity 훅 설정 위치](https://antigravity.google/docs/hooks)
|
|
69
|
+
|
|
70
|
+
`find`와 `hooks`는 지정한 디렉터리와 그 하위를 탐색합니다. `DIR`을 생략하면 사용자 홈에서 시작합니다. 인자 없는 `hooks`는 홈 밖에 지정한 대상 에이전트의 전역 설정 디렉터리도 확인합니다. 접근할 수 없는 디렉터리는 건너뜁니다.
|
|
71
|
+
|
|
72
|
+
터미널에서는 진행 줄을 `디렉터리명...`으로 갱신하다가 대상을 찾으면 `디렉터리명... found`로 표시합니다. 색상을 지원하는 터미널에서는 `found`만 초록색입니다. 탐색이 끝나면 그 줄을 지우고 결과를 출력합니다.
|
|
73
|
+
|
|
74
|
+
`agent-auto-approve --help`로 명령 목록을 확인하고, `agent-auto-approve find --help`처럼 명령 뒤에 `--help`를 붙여 해당 명령의 인자와 옵션을 확인할 수 있습니다. `-h`도 사용할 수 있습니다.
|
|
75
|
+
|
|
76
|
+
## 자동 승인 범위
|
|
77
|
+
|
|
78
|
+
기본 모드는 훅에 전달된 도구 승인 요청을 자동 승인합니다. 사용자의 답변이 필요한 Claude Code와 Antigravity의 질문은 기존 흐름을 따릅니다. `--workspace-only`를 붙이면 대상 경로와 해당하는 경우 명령 실행 위치가 아래 기준 안에 있다고 확인된 경우에만 자동 승인합니다.
|
|
79
|
+
|
|
80
|
+
| 설정 방법 | 기준 디렉터리 |
|
|
81
|
+
| --- | --- |
|
|
82
|
+
| `agent-auto-approve install --workspace-only` | Codex는 세션의 작업 디렉터리, Claude Code는 세션이 시작된 프로젝트 루트, Antigravity는 훅의 `workspacePaths`에 전달된 작업 디렉터리를 사용합니다. |
|
|
83
|
+
| `agent-auto-approve install DIR --workspace-only` | 지정한 프로젝트 루트 `DIR` |
|
|
84
|
+
| `agent-auto-approve launch --workspace-only` | `launch`를 실행한 디렉터리 |
|
|
85
|
+
|
|
86
|
+
경로 판별은 단순한 POSIX `touch`·`mkdir` 명령, Codex의 명시적인 파일시스템 권한 요청, Claude Code와 Antigravity의 절대 경로를 지정한 기본 파일 도구를 지원합니다. Antigravity는 파일 읽기·생성·편집과 디렉터리 목록의 명시적 경로를 확인합니다. Antigravity 명령 요청에 실행 디렉터리(`Cwd`)가 없으면 명령의 대상 경로가 절대 경로일 때만 확인합니다. 작업 범위 밖의 경로나 확인하기 어려운 요청은 각 에이전트의 기존 승인 절차로 넘어갑니다. 예를 들어 `~/work/test`가 기준일 때 `touch ~/note.txt`는 홈 디렉터리에 파일을 생성하므로 기존 승인 절차를 따릅니다.
|
|
87
|
+
|
|
88
|
+
Claude Code의 명시적인 거부 규칙, 관리형 훅 설정, 작업 공간 신뢰 정책은 계속 적용됩니다. 네트워크 샌드박스 승인 창은 별도 경로로 처리됩니다. 전역 훅과 프로젝트 훅을 함께 설치하면 두 등록이 함께 적용될 수 있으므로, 작업 범위 제한이 필요하면 적용되는 등록의 모드를 확인합니다. [Claude Code 훅 문서](https://code.claude.com/docs/en/hooks#permissionrequest)
|
|
89
|
+
|
|
90
|
+
같은 에이전트에 이 도구의 전역 훅이 등록돼 있으면 프로젝트 `install DIR` 또는 `launch` 전에 전역 설정 경로와 승인 모드를 경고하고 계속할지 묻습니다. `y`를 입력하면 진행하고, `n`이나 빈 입력이면 중단합니다.
|
|
91
|
+
|
|
92
|
+
## 제거
|
|
93
|
+
|
|
94
|
+
프로젝트 루트에서 `agent-auto-approve uninstall .`을 실행하면 해당 프로젝트의 등록을 제거합니다. 전역 등록은 `agent-auto-approve uninstall`로 제거할 수 있으며, 홈 밖에 설정한 전역 등록도 이 명령에 해당합니다. Claude Code는 `--claude`, Antigravity는 `--agy`를 붙입니다. 이 도구가 제거하는 범위는 자신이 등록한 훅입니다.
|
|
95
|
+
|
|
96
|
+
등록된 훅을 제거한 뒤 다음 명령으로 CLI를 제거할 수 있습니다.
|
|
97
|
+
|
|
98
|
+
```sh
|
|
99
|
+
uv tool uninstall agent-auto-approve
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
## 패키지 빌드
|
|
103
|
+
|
|
104
|
+
저장소 루트에서 `uv build`를 실행하면 `dist/`에 wheel과 소스 배포 파일이 생성됩니다.
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: agent-auto-approve
|
|
3
|
+
Version: 0.1.1
|
|
4
|
+
Summary: Manage approval hooks for Codex, Claude Code, and Antigravity CLI.
|
|
5
|
+
Home-page: https://github.com/jiind/agent-auto-approve
|
|
6
|
+
License: MIT
|
|
7
|
+
Project-URL: Issues, https://github.com/jiind/agent-auto-approve/issues
|
|
8
|
+
Requires-Python: >=3.8
|
|
9
|
+
Description-Content-Type: text/markdown
|
|
10
|
+
License-File: LICENSE
|
|
11
|
+
Dynamic: license-file
|
|
12
|
+
|
|
13
|
+
# Agent Auto Approve
|
|
14
|
+
|
|
15
|
+
`agent-auto-approve`는 Codex CLI, Claude Code, Antigravity CLI의 도구 승인 훅을 관리하는 Python CLI입니다. 프로젝트별 또는 전역으로 등록할 수 있습니다. Codex와 Claude Code는 새 세션 하나에 적용할 수도 있습니다.
|
|
16
|
+
|
|
17
|
+
## 빠른 시작
|
|
18
|
+
|
|
19
|
+
CLI는 Python 3.8 이상에서 실행됩니다. 아래 설치 예시에는 `uv`를 사용합니다. `launch`는 대상 에이전트의 CLI를 PATH에서 찾습니다. Windows에서 Claude Code 세션을 시작하려면 네이티브 `claude.exe`가 필요합니다. Claude Code 훅은 [`args`를 지원하는 2.1.139 이상](https://code.claude.com/docs/en/changelog)을 사용합니다.
|
|
20
|
+
|
|
21
|
+
`pyproject.toml`이 있는 이 저장소의 루트에서 CLI를 설치합니다.
|
|
22
|
+
|
|
23
|
+
```sh
|
|
24
|
+
git clone https://github.com/jiind/agent-auto-approve.git
|
|
25
|
+
cd agent-auto-approve
|
|
26
|
+
uv tool install .
|
|
27
|
+
agent-auto-approve --help
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
`install`과 `launch`에서 `--workspace-only`를 생략하면 훅에 전달되는 승인 요청에 작업 경로 제한이 적용되지 않습니다. 작업 디렉터리 안에서만 자동 승인하려면 아래 예시처럼 이 옵션을 붙입니다.
|
|
31
|
+
|
|
32
|
+
설정할 프로젝트의 루트로 이동합니다. `.codex` 디렉터리가 있는 프로젝트에서 다음 명령으로 작업 범위 제한을 켜고 훅을 등록한 뒤 확인할 수 있습니다.
|
|
33
|
+
|
|
34
|
+
```sh
|
|
35
|
+
agent-auto-approve install . --workspace-only
|
|
36
|
+
agent-auto-approve hooks .
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
새 Codex 세션 하나에서 써보려면 해당 프로젝트에서 다음 명령을 실행합니다.
|
|
40
|
+
|
|
41
|
+
```sh
|
|
42
|
+
agent-auto-approve launch --workspace-only
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
Claude Code는 `--claude`로 선택합니다. `.claude`가 있는 프로젝트 루트에서 아래 명령을 실행하면 작업 범위를 제한한 훅을 등록하고 확인할 수 있습니다.
|
|
46
|
+
|
|
47
|
+
```sh
|
|
48
|
+
agent-auto-approve install --claude . --workspace-only
|
|
49
|
+
agent-auto-approve hooks --claude .
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
Claude Code 세션 하나에만 적용하려면 `agent-auto-approve launch --claude --workspace-only`를 실행합니다.
|
|
53
|
+
|
|
54
|
+
Antigravity CLI는 `--agy`로 선택합니다. `.agents`가 있는 프로젝트 루트에서 훅을 등록하고 확인한 뒤 `agy`를 실행합니다. [Antigravity CLI 공식 문서](https://antigravity.google/docs/cli/reference/)
|
|
55
|
+
|
|
56
|
+
```sh
|
|
57
|
+
agent-auto-approve install --agy . --workspace-only
|
|
58
|
+
agent-auto-approve hooks --agy .
|
|
59
|
+
agy
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
## 명령
|
|
63
|
+
|
|
64
|
+
| 명령 | 동작 |
|
|
65
|
+
| --- | --- |
|
|
66
|
+
| `agent-auto-approve install [DIR] [--workspace-only]` | `DIR`을 지정하면 프로젝트에, 생략하면 사용자 전역에 훅을 등록합니다. 프로젝트에 대상 에이전트의 `.codex`, `.claude` 또는 `.agents`가 있어야 합니다. |
|
|
67
|
+
| `agent-auto-approve launch [--claude] [--workspace-only]` | 운영체제를 감지하고 훅을 적용한 새 세션을 시작합니다. Codex는 임시 훅 스크립트를, Claude Code는 임시 설정 파일을 사용하며 세션이 끝나면 해당 파일을 제거합니다. |
|
|
68
|
+
| `agent-auto-approve find [DIR] [--agy] [--claude] [--codex]` | `.agents`, `.claude`, `.codex` 디렉터리의 절대 경로를 한 줄에 하나씩 출력합니다. 옵션을 조합하면 선택한 디렉터리를, 생략하면 지원하는 디렉터리를 모두 찾습니다. |
|
|
69
|
+
| `agent-auto-approve hooks [DIR]` | 등록된 훅의 범위, 승인 모드, 설정 파일의 절대 경로를 출력합니다. |
|
|
70
|
+
| `agent-auto-approve uninstall [DIR] [--all]` | `DIR`을 지정하면 프로젝트의 훅을, 생략하면 전역 훅을 제거합니다. `--all`은 지정한 `DIR` 아래를 재귀 탐색하며, 이때 `DIR`을 생략하면 홈 아래를 탐색합니다. |
|
|
71
|
+
|
|
72
|
+
`install`, `hooks`, `uninstall`에는 `--agy`, `--claude`, `--codex` 중 하나를 지정할 수 있습니다. `launch`에는 `--claude` 또는 `--codex`를 지정할 수 있습니다. 이 명령들의 기본 대상은 Codex입니다.
|
|
73
|
+
|
|
74
|
+
| 대상 | 전역 등록 파일 | 프로젝트 등록 파일 |
|
|
75
|
+
| --- | --- | --- |
|
|
76
|
+
| Codex | `CODEX_HOME/hooks.json`, 기본 `~/.codex/hooks.json` | `DIR/.codex/hooks.json` |
|
|
77
|
+
| Claude Code | `CLAUDE_CONFIG_DIR/settings.json`, 기본 `~/.claude/settings.json` | `DIR/.claude/settings.local.json` |
|
|
78
|
+
| Antigravity CLI | `~/.gemini/config/hooks.json` | `DIR/.agents/hooks.json` |
|
|
79
|
+
|
|
80
|
+
Antigravity는 이 훅 설정 파일을 CLI, 앱, IDE에서 공통으로 읽습니다. [Antigravity 훅 설정 위치](https://antigravity.google/docs/hooks)
|
|
81
|
+
|
|
82
|
+
`find`와 `hooks`는 지정한 디렉터리와 그 하위를 탐색합니다. `DIR`을 생략하면 사용자 홈에서 시작합니다. 인자 없는 `hooks`는 홈 밖에 지정한 대상 에이전트의 전역 설정 디렉터리도 확인합니다. 접근할 수 없는 디렉터리는 건너뜁니다.
|
|
83
|
+
|
|
84
|
+
터미널에서는 진행 줄을 `디렉터리명...`으로 갱신하다가 대상을 찾으면 `디렉터리명... found`로 표시합니다. 색상을 지원하는 터미널에서는 `found`만 초록색입니다. 탐색이 끝나면 그 줄을 지우고 결과를 출력합니다.
|
|
85
|
+
|
|
86
|
+
`agent-auto-approve --help`로 명령 목록을 확인하고, `agent-auto-approve find --help`처럼 명령 뒤에 `--help`를 붙여 해당 명령의 인자와 옵션을 확인할 수 있습니다. `-h`도 사용할 수 있습니다.
|
|
87
|
+
|
|
88
|
+
## 자동 승인 범위
|
|
89
|
+
|
|
90
|
+
기본 모드는 훅에 전달된 도구 승인 요청을 자동 승인합니다. 사용자의 답변이 필요한 Claude Code와 Antigravity의 질문은 기존 흐름을 따릅니다. `--workspace-only`를 붙이면 대상 경로와 해당하는 경우 명령 실행 위치가 아래 기준 안에 있다고 확인된 경우에만 자동 승인합니다.
|
|
91
|
+
|
|
92
|
+
| 설정 방법 | 기준 디렉터리 |
|
|
93
|
+
| --- | --- |
|
|
94
|
+
| `agent-auto-approve install --workspace-only` | Codex는 세션의 작업 디렉터리, Claude Code는 세션이 시작된 프로젝트 루트, Antigravity는 훅의 `workspacePaths`에 전달된 작업 디렉터리를 사용합니다. |
|
|
95
|
+
| `agent-auto-approve install DIR --workspace-only` | 지정한 프로젝트 루트 `DIR` |
|
|
96
|
+
| `agent-auto-approve launch --workspace-only` | `launch`를 실행한 디렉터리 |
|
|
97
|
+
|
|
98
|
+
경로 판별은 단순한 POSIX `touch`·`mkdir` 명령, Codex의 명시적인 파일시스템 권한 요청, Claude Code와 Antigravity의 절대 경로를 지정한 기본 파일 도구를 지원합니다. Antigravity는 파일 읽기·생성·편집과 디렉터리 목록의 명시적 경로를 확인합니다. Antigravity 명령 요청에 실행 디렉터리(`Cwd`)가 없으면 명령의 대상 경로가 절대 경로일 때만 확인합니다. 작업 범위 밖의 경로나 확인하기 어려운 요청은 각 에이전트의 기존 승인 절차로 넘어갑니다. 예를 들어 `~/work/test`가 기준일 때 `touch ~/note.txt`는 홈 디렉터리에 파일을 생성하므로 기존 승인 절차를 따릅니다.
|
|
99
|
+
|
|
100
|
+
Claude Code의 명시적인 거부 규칙, 관리형 훅 설정, 작업 공간 신뢰 정책은 계속 적용됩니다. 네트워크 샌드박스 승인 창은 별도 경로로 처리됩니다. 전역 훅과 프로젝트 훅을 함께 설치하면 두 등록이 함께 적용될 수 있으므로, 작업 범위 제한이 필요하면 적용되는 등록의 모드를 확인합니다. [Claude Code 훅 문서](https://code.claude.com/docs/en/hooks#permissionrequest)
|
|
101
|
+
|
|
102
|
+
같은 에이전트에 이 도구의 전역 훅이 등록돼 있으면 프로젝트 `install DIR` 또는 `launch` 전에 전역 설정 경로와 승인 모드를 경고하고 계속할지 묻습니다. `y`를 입력하면 진행하고, `n`이나 빈 입력이면 중단합니다.
|
|
103
|
+
|
|
104
|
+
## 제거
|
|
105
|
+
|
|
106
|
+
프로젝트 루트에서 `agent-auto-approve uninstall .`을 실행하면 해당 프로젝트의 등록을 제거합니다. 전역 등록은 `agent-auto-approve uninstall`로 제거할 수 있으며, 홈 밖에 설정한 전역 등록도 이 명령에 해당합니다. Claude Code는 `--claude`, Antigravity는 `--agy`를 붙입니다. 이 도구가 제거하는 범위는 자신이 등록한 훅입니다.
|
|
107
|
+
|
|
108
|
+
등록된 훅을 제거한 뒤 다음 명령으로 CLI를 제거할 수 있습니다.
|
|
109
|
+
|
|
110
|
+
```sh
|
|
111
|
+
uv tool uninstall agent-auto-approve
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
## 패키지 빌드
|
|
115
|
+
|
|
116
|
+
저장소 루트에서 `uv build`를 실행하면 `dist/`에 wheel과 소스 배포 파일이 생성됩니다.
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
LICENSE
|
|
2
|
+
README.md
|
|
3
|
+
codex_approval_hook.py
|
|
4
|
+
pyproject.toml
|
|
5
|
+
setup.cfg
|
|
6
|
+
agent_auto_approve.egg-info/PKG-INFO
|
|
7
|
+
agent_auto_approve.egg-info/SOURCES.txt
|
|
8
|
+
agent_auto_approve.egg-info/dependency_links.txt
|
|
9
|
+
agent_auto_approve.egg-info/entry_points.txt
|
|
10
|
+
agent_auto_approve.egg-info/top_level.txt
|
|
11
|
+
tests/test_approval_hook.py
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
codex_approval_hook
|