ccperm 1.9.2 → 1.9.4

package/README.ko.md

@@ -4,84 +4,78 @@
 
 [English](README.md)
 
-Claude Code는 프로젝트마다 `.claude/settings*.json`에 허용한 권한(Bash 명령, WebFetch 도메인, MCP 도구 등)을 저장합니다. 여러 프로젝트를 오가다 보면 어디서 뭘 허용했는지 파악하기 어려운데, **ccperm**으로 전체 권한을 한번에 점검할 수 있습니다.
+Claude Code는 프로젝트마다 `.claude/settings*.json`에 허용한 권한(Bash 명령, WebFetch 도메인, MCP 도구 등)을 저장합니다. 여러 프로젝트를 오가다 보면 어디서 뭘 허용했는지 파악하기 어려운데, **ccperm**은 홈 디렉토리 전체를 스캔해서 모든 설정 파일을 찾고, 인터랙티브 TUI 또는 텍스트로 보여줍니다.
 
 ## 빠른 시작
 
 ```bash
-npx ccperm --all
+npx ccperm
 ```
 
 설치 없이 바로 실행됩니다. 글로벌 설치도 가능:
 
 ```bash
 npm i -g ccperm
-ccperm --all
+ccperm
 ```
 
-## 사용법
-
-```bash
-npx ccperm              # 현재 프로젝트 권한 점검
-npx ccperm --all        # 홈 디렉토리 아래 모든 프로젝트 점검
-npx ccperm --fix        # deprecated 패턴 자동 수정
-npx ccperm --all --fix  # 전체 점검 + 수정
-```
-
-## 출력 예시
-
-```
-━━━ Claude Code Permission Audit ━━━
-
-Scope: ~ (all projects)
-Scanned 12 files:
-
-  ~/Documents/project-a/.claude/settings.local.json  (Bash: 5, WebFetch: 3, Tools: 1)
-    Bash (5)
-      npm run build *
-      docker compose *
-      curl *
-      git add *
-      ssh *
-    WebFetch (3)
-      github.com
-      docs.anthropic.com
-      api.example.com
-    Tools (1)
-      WebSearch
-
-  ~/Documents/project-b/.claude/settings.local.json  (Bash: 2, MCP: 3)
-    Bash (2)
-      python3 *
-      pytest *
-    MCP (3)
-      browseros__browser_navigate
-      browseros__browser_click_element
-      browseros__browser_get_screenshot
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-All clean! No deprecated :* patterns found.
-```
+기본 동작: `~` 아래 모든 프로젝트를 스캔하고 인터랙티브 TUI를 실행합니다.
 
 ## 옵션
 
 | 플래그 | 설명 |
 |--------|------|
-| `--all` | 홈 디렉토리 아래 전체 프로젝트 스캔 |
-| `--fix` | deprecated `:*` 패턴을 ` *`로 자동 수정 |
+| `--cwd` | 현재 디렉토리만 스캔 (기본값: `~` 아래 전체) |
+| `--static` | 텍스트 출력 강제 (파이프/비TTY 환경에서 기본값) |
+| `--verbose` | 모든 권한을 상세 나열하는 텍스트 출력 |
+| `--update` | `npm install -g ccperm@latest`로 자체 업데이트 |
+| `--debug` | 스캔 진단 정보 표시 (파일 경로, 소요 시간) |
 | `--help`, `-h` | 도움말 표시 |
 | `--version`, `-v` | 버전 표시 |
-| `--update` | 업데이트 확인 |
 
-## Deprecated 패턴 수정
+## 인터랙티브 TUI
+
+TTY 환경(기본)에서는 박스 프레임 TUI가 실행됩니다:
 
-Claude Code가 이전에 "Allow always" 권한을 `:*`로 저장하는 버그가 있었습니다. 이로 인해 권한 팝업이 반복되는데, `--fix`로 자동 수정할 수 있습니다.
+**목록 뷰** -- 프로젝트가 권한 수 기준으로 정렬됩니다. 상단에 `GLOBAL` 섹션이 `~/.claude/` 설정을 보여줍니다. 각 행은 카테고리별 개수(Bash, WebFetch, MCP, Tools)와 `shared`/`local` 라벨로 `settings.json`과 `settings.local.json`을 구분합니다. 최대 25행 표시, 나머지는 스크롤.
 
 ```
-수정 전: Bash(npm run build:*)
-수정 후: Bash(npm run build *)
+┌ ccperm ──────────────────────────────── 1/8 ┐
+│ PROJECT          Bash  WebFetch   MCP  TOTAL │
+├──────────────────────────────────────────────┤
+│ ★ GLOBAL                           2      2 │
+├──────────────────────────────────────────────┤
+│▸ my-project  local  5       3     ·      8 │
+│  other-app   shared 2       ·     3      5 │
+│  ...                                        │
+└ [↑↓] navigate  [Enter] detail  [q] quit ────┘
 ```
 
+**상세 뷰** -- Enter로 프로젝트를 펼칩니다. 카테고리(Bash, WebFetch, MCP, Tools)를 Enter로 접고 펼 수 있습니다.
+
+**정보 모드** -- `[i]`를 누르면 각 권한에 위험도 표시(`●` 초록/노랑/빨강)와 설명이 나타납니다.
+
+키 조작: `↑↓` 이동, `Enter` 선택/펼치기, `[i]` 정보 토글, `Esc`/`Backspace` 뒤로, `q`/`Ctrl+C` 종료.
+
+## 텍스트 출력
+
+`--static` 플래그(또는 파이프)로 텍스트 출력:
+
+```bash
+ccperm --static           # 요약 테이블
+ccperm --static --verbose  # 전체 권한 상세 나열
+```
+
+## 권한 레벨
+
+ccperm은 Claude Code 설정을 세 단계로 구분합니다:
+
+| 레벨 | 파일 | 범위 |
+|------|------|------|
+| **global** | `~/.claude/settings.json` | 모든 프로젝트에 적용 |
+| **shared** | `<project>/.claude/settings.json` | 프로젝트별, git에 커밋됨 |
+| **local** | `<project>/.claude/settings.local.json` | 프로젝트별, gitignore 대상 |
+
 ## 요구사항
 
 - Node.js >= 18

package/README.md

@@ -4,84 +4,78 @@ Audit Claude Code permissions across all your projects.
 
 [한국어](README.ko.md)
 
-Claude Code stores allowed permissions (Bash commands, WebFetch domains, MCP tools, etc.) in `.claude/settings*.json` per project. As you work across many projects, these permissions pile up silently. **ccperm** lets you see exactly what you've allowed, everywhere.
+Claude Code stores allowed permissions (Bash commands, WebFetch domains, MCP tools, etc.) in `.claude/settings*.json` per project. As you work across many projects, these permissions pile up silently. **ccperm** scans your home directory, finds every settings file, and shows what you've allowed -- in an interactive TUI or static text output.
 
 ## Quick Start
 
 ```bash
-npx ccperm --all
+npx ccperm
 ```
 
 No install needed. Or install globally:
 
 ```bash
 npm i -g ccperm
-ccperm --all
+ccperm
 ```
 
-## Usage
-
-```bash
-npx ccperm              # Audit current project
-npx ccperm --all        # Audit all projects under ~
-npx ccperm --fix        # Auto-fix deprecated patterns
-npx ccperm --all --fix  # Audit + fix all projects
-```
-
-## Output example
-
-```
-━━━ Claude Code Permission Audit ━━━
-
-Scope: ~ (all projects)
-Scanned 12 files:
-
-  ~/Documents/project-a/.claude/settings.local.json  (Bash: 5, WebFetch: 3, Tools: 1)
-    Bash (5)
-      npm run build *
-      docker compose *
-      curl *
-      git add *
-      ssh *
-    WebFetch (3)
-      github.com
-      docs.anthropic.com
-      api.example.com
-    Tools (1)
-      WebSearch
-
-  ~/Documents/project-b/.claude/settings.local.json  (Bash: 2, MCP: 3)
-    Bash (2)
-      python3 *
-      pytest *
-    MCP (3)
-      browseros__browser_navigate
-      browseros__browser_click_element
-      browseros__browser_get_screenshot
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-All clean! No deprecated :* patterns found.
-```
+By default, ccperm scans all projects under `~` and launches an interactive TUI.
 
 ## Options
 
 | Flag | Description |
 |------|-------------|
-| `--all` | Scan all projects under home directory |
-| `--fix` | Auto-fix deprecated `:*` patterns to ` *` |
+| `--cwd` | Scan current directory only (default: all projects under `~`) |
+| `--static` | Force text output (default when piped / non-TTY) |
+| `--verbose` | Detailed static output with all permissions listed |
+| `--update` | Self-update via `npm install -g ccperm@latest` |
+| `--debug` | Show scan diagnostics (file paths, timing) |
 | `--help`, `-h` | Show help |
 | `--version`, `-v` | Show version |
-| `--update` | Check for updates |
 
-## Deprecated pattern fix
+## Interactive TUI
+
+When running in a TTY (the default), ccperm opens a box-frame TUI:
 
-Claude Code previously saved "Allow always" permissions with `:*` instead of ` *`, causing permission popups to repeat. `--fix` detects and corrects this automatically.
+**List view** -- Projects sorted by permission count. `GLOBAL` section at top shows `~/.claude/` settings. Each row shows category counts (Bash, WebFetch, MCP, Tools) and a `shared`/`local` label distinguishing `settings.json` vs `settings.local.json`. Max 25 visible rows; scroll for more.
 
 ```
-Before: Bash(npm run build:*)
-After:  Bash(npm run build *)
+┌ ccperm ──────────────────────────────── 1/8 ┐
+│ PROJECT          Bash  WebFetch   MCP  TOTAL │
+├──────────────────────────────────────────────┤
+│ ★ GLOBAL                           2      2 │
+├──────────────────────────────────────────────┤
+│▸ my-project  local  5       3     ·      8 │
+│  other-app   shared 2       ·     3      5 │
+│  ...                                        │
+└ [↑↓] navigate  [Enter] detail  [q] quit ────┘
 ```
 
+**Detail view** -- Press Enter to expand a project. Categories (Bash, WebFetch, MCP, Tools) are collapsible; press Enter to toggle.
+
+**Info mode** -- Press `[i]` to show risk indicators (`●` green/yellow/red) and descriptions for each permission.
+
+Keys: `↑↓` navigate, `Enter` select/expand, `[i]` toggle info, `Esc`/`Backspace` back, `q`/`Ctrl+C` quit.
+
+## Static Output
+
+Use `--static` (or pipe to another command) for text output:
+
+```bash
+ccperm --static           # compact table
+ccperm --static --verbose  # full permission listing
+```
+
+## Permission Levels
+
+ccperm distinguishes three levels of Claude Code settings:
+
+| Level | File | Scope |
+|-------|------|-------|
+| **global** | `~/.claude/settings.json` | Applies to all projects |
+| **shared** | `<project>/.claude/settings.json` | Per-project, committed to git |
+| **local** | `<project>/.claude/settings.local.json` | Per-project, gitignored |
+
 ## Requirements
 
 - Node.js >= 18

package/dist/aggregator.js

@@ -19,7 +19,7 @@ function toFileEntries(results) {
             groups.set(g.category, g.items.length);
         }
         const fileType = r.isGlobal ? 'global' : r.display.includes('settings.local.json') ? 'local' : 'shared';
-        const name = r.isGlobal ? 'GLOBAL' : shortPath(r.display);
+        const name = r.isGlobal ? '~/.claude' : shortPath(r.display);
         return { display: r.display, shortName: name, totalCount: r.totalCount, groups, isGlobal: r.isGlobal, fileType };
     });
 }

package/dist/interactive.js

@@ -120,7 +120,7 @@ function renderList(state, withPerms, emptyCount) {
     const cats = ['Bash', 'WebFetch', 'MCP', 'Tools'];
     const catsPresent = cats.filter((c) => withPerms.some((r) => r.groups.has(c)));
     const catColWidth = catsPresent.length * 7;
-    const maxName = Math.max(...withPerms.map((r) => r.isGlobal ? r.shortName.length + 2 : r.shortName.length), 7);
+    const maxName = Math.max(...withPerms.map((r) => r.shortName.length), 7);
     const nameWidth = Math.min(maxName, inner - catColWidth - 16);
     const hasGlobalSep = withPerms.some((r) => r.isGlobal) && withPerms.some((r) => !r.isGlobal);
     // box takes: top(1) + header(2) + sep(1) + content + globalSep?(1) + emptyLine?(1) + bottom(1)
@@ -140,8 +140,7 @@ function renderList(state, withPerms, emptyCount) {
     for (let i = state.scrollOffset; i < end; i++) {
         const r = withPerms[i];
         const isCursor = i === state.cursor;
-        const displayName = r.isGlobal ? `★ ${r.shortName}` : r.shortName;
-        const truncName = displayName.length > nameWidth ? displayName.slice(0, nameWidth - 1) + '…' : displayName;
+        const truncName = r.shortName.length > nameWidth ? r.shortName.slice(0, nameWidth - 1) + '…' : r.shortName;
         const typeTag = r.isGlobal ? pad('', 7) : `${colors_js_1.DIM} ${pad(r.fileType, 6)}${colors_js_1.NC}`;
         const marker = isCursor ? `${colors_js_1.CYAN}▸ ` : '  ';
         const nameStyle = isCursor ? `${colors_js_1.BOLD}` : r.isGlobal ? `${colors_js_1.YELLOW}` : '';

package/dist/renderer.js

@@ -19,7 +19,7 @@ function printCompact(entries, summary) {
     const withPerms = [...globals, ...projects];
     const emptyCount = entries.filter((r) => r.totalCount === 0 && !r.isGlobal).length;
     // header
-    const maxName = Math.max(...withPerms.map((r) => r.isGlobal ? r.shortName.length + 2 : r.shortName.length), 7);
+    const maxName = Math.max(...withPerms.map((r) => r.shortName.length), 7);
     const nameWidth = Math.min(maxName, 40);
     const header = `  ${colors_js_1.DIM}${pad('PROJECT', nameWidth)}  ${catsPresent.map((c) => rpad(c, 5)).join('  ')}  TOTAL${colors_js_1.NC}`;
     console.log(header);
@@ -27,8 +27,7 @@ function printCompact(entries, summary) {
     // rows
     for (let i = 0; i < withPerms.length; i++) {
         const result = withPerms[i];
-        const displayName = result.isGlobal ? `★ ${result.shortName}` : result.shortName;
-        const truncName = displayName.length > nameWidth ? displayName.slice(0, nameWidth - 1) + '…' : displayName;
+        const truncName = result.shortName.length > nameWidth ? result.shortName.slice(0, nameWidth - 1) + '…' : result.shortName;
         const typeTag = result.isGlobal ? pad('', 7) : `${colors_js_1.DIM} ${pad(result.fileType, 6)}${colors_js_1.NC}`;
         const nameStyle = result.isGlobal ? `${colors_js_1.YELLOW}` : '';
         const nameCol = `  ${nameStyle}${pad(truncName, nameWidth)}${colors_js_1.NC}${typeTag}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccperm",
-  "version": "1.9.2",
+  "version": "1.9.4",
   "description": "Audit Claude Code permissions across all your projects",
   "bin": {
     "ccperm": "bin/ccperm.js"