difit 3.1.9 → 3.1.11

package/README.ja.md

@@ -25,6 +25,12 @@ npm install -g difit
 difit  # 最新コミットのdiffをWebUIで表示
 ```
 
+AIエージェントから使えるようにする
+
+```bash
+npx skills add yoshiko-pg/difit # エージェントにスキルを追加
+```
+
 ## 🚀 使い方
 
 ### 基本的な使い方
@@ -66,19 +72,19 @@ difit working  # 未ステージ差分のみ
 difit --pr https://github.com/owner/repo/pull/123
 ```
 
-difitは以下の方法でGitHub認証を自動的に処理します：
+`--pr` モードでは、内部で `gh pr diff --patch` を実行してパッチを取得します。
+
+認証は GitHub CLI が処理します：
 
-1. **GitHub CLI**（推奨）：`gh auth login`でログイン済みの場合、既存の認証情報を使用
-2. **環境変数**：`GITHUB_TOKEN`環境変数を設定
-3. **認証なし**：パブリックリポジトリは認証なしで動作（レート制限あり）
+1. **一度ログイン**（推奨）：`gh auth login`
+2. **トークン認証**（CI/非対話環境）：`GH_TOKEN` または `GITHUB_TOKEN` を設定
 
 #### GitHub Enterprise Server
 
-Enterprise ServerのPRを表示する場合、あなたのEnterprise Serverインスタンスで生成されたトークンを設定する必要があります：
+Enterprise Server の PR を表示する場合は、GitHub CLI を Enterprise ホスト向けに認証してください：
 
-1. `https://YOUR-ENTERPRISE-SERVER/settings/tokens`にアクセス
-2. 適切なスコープでパーソナルアクセストークンを生成
-3. `GITHUB_TOKEN`環境変数として設定
+1. `gh auth login --hostname YOUR-ENTERPRISE-SERVER`
+2. または `GH_HOST=YOUR-ENTERPRISE-SERVER` と `GH_TOKEN` / `GITHUB_TOKEN` を設定
 
 ### 標準入力
 
@@ -121,6 +127,7 @@ git diff --cached | difit -
 | `--tui`               | false      | WebUIの代わりにターミナルUIを使用                                                 |
 | `--clean`             | false      | 起動時に既存コメントと閲覧済みファイルをすべてクリア                              |
 | `--include-untracked` | false      | diffにuntrackedファイルを自動的に含める（`.`または`working`のみ有効）             |
+| `--keep-alive`        | false      | ブラウザ切断後もサーバーを終了せず起動したままにする（Ctrl+Cで手動停止）          |
 
 ## 💬 コメントシステム
 
@@ -146,6 +153,16 @@ src/components/Button.tsx:L42-L48   # この行が自動的に追加されます
 この部分は不要です
 ```
 
+## 🤖 エージェントからの呼び出し
+
+difitを利用してユーザーにレビューを依頼するSkillを以下でインストールできます。
+
+```sh
+npx skills add yoshiko-pg/difit
+```
+
+エージェントがコードを編集したあと、difitサーバーを立ち上げるようになります。
+
 ## 🎨 シンタックスハイライト対応言語
 
 - **JavaScript/TypeScript**：`.js`, `.jsx`, `.ts`, `.tsx`
@@ -201,10 +218,9 @@ pnpm run build
 # テストの実行
 pnpm test
 
-# リントとフォーマット
-pnpm run lint
+# 型チェックとlintとフォーマット
+pnpm run check
 pnpm run format
-pnpm run typecheck
 ```
 
 ### 開発ワークフロー
@@ -218,17 +234,18 @@ pnpm run typecheck
 
 - **CLI**：包括的なバリデーションを備えたCommander.jsでの引数解析
 - **バックエンド**：diff処理用のsimple-gitを備えたExpressサーバー
-- **GitHub統合**：自動認証（GitHub CLI + 環境変数）を備えたOctokitでのGitHub API
+- **GitHub統合**：GitHub CLI（`gh pr diff --patch`）によるPRパッチ取得
 - **フロントエンド**：React 18 + TypeScript + Vite
 - **スタイリング**：GitHubライクなダークテーマを備えたTailwind CSS v4
 - **シンタックスハイライト**：動的言語ロードを備えたPrism.js
 - **テスト**：同じ場所に配置されたテストファイルを使用したVitestユニットテスト
-- **品質**：ESLint、Prettier、lefthookプリコミットフック
+- **品質**：oxlint、oxfmt、lefthookプリコミットフック
 
 ## 📋 要件
 
 - Node.js ≥ 21.0.0
 - レビューするコミットを含むGitリポジトリ
+- `--pr` モード利用時は GitHub CLI（`gh`）
 
 ## 📄 ライセンス
 

package/README.ko.md

@@ -25,6 +25,12 @@ npm install -g difit
 difit  # WebUI에서 최신 커밋 diff 보기
 ```
 
+AI 에이전트에서 사용할 수 있도록 설정
+
+```bash
+npx skills add yoshiko-pg/difit # 에이전트에 Skill 추가
+```
+
 ## 🚀 사용법
 
 ### 기본 사용법
@@ -66,19 +72,19 @@ difit working  # 미스테이징 변경 사항만
 difit --pr https://github.com/owner/repo/pull/123
 ```
 
-difit은 다음 방법으로 GitHub 인증을 자동으로 처리합니다:
+`--pr` 모드는 내부적으로 `gh pr diff --patch`를 실행해 패치를 가져옵니다.
+
+인증은 GitHub CLI가 처리합니다:
 
-1. **GitHub CLI** (권장): `gh auth login`으로 로그인한 경우 기존 자격 증명 사용
-2. **환경 변수**: `GITHUB_TOKEN` 환경 변수 설정
-3. **인증 없음**: 공개 저장소는 인증 없이 작동 (속도 제한 있음)
+1. **한 번 로그인** (권장): `gh auth login`
+2. **토큰 인증** (CI/비대화형 환경): `GH_TOKEN` 또는 `GITHUB_TOKEN` 설정
 
 #### GitHub Enterprise Server
 
-Enterprise Server PR의 경우 귀하의 Enterprise Server 인스턴스에서 생성된 토큰을 설정해야 합니다:
+Enterprise Server PR의 경우 GitHub CLI를 Enterprise 호스트에 인증하세요:
 
-1. `https://YOUR-ENTERPRISE-SERVER/settings/tokens`로 이동
-2. 적절한 범위로 개인 액세스 토큰 생성
-3. `GITHUB_TOKEN` 환경 변수로 설정
+1. `gh auth login --hostname YOUR-ENTERPRISE-SERVER`
+2. 또는 `GH_HOST=YOUR-ENTERPRISE-SERVER`와 `GH_TOKEN`/`GITHUB_TOKEN` 설정
 
 ### 표준 입력
 
@@ -121,6 +127,7 @@ git diff --cached | difit -
 | `--tui`               | false     | WebUI 대신 터미널 UI 모드 사용                                    |
 | `--clean`             | false     | 시작 시 모든 기존 코멘트와 열람된 파일 표시 초기화                |
 | `--include-untracked` | false     | diff에 untracked 파일 자동 포함 (`.` 또는 `working`에서만 유효)   |
+| `--keep-alive`        | false     | 브라우저 연결이 끊겨도 서버 유지 (Ctrl+C로 수동 종료)             |
 
 ## 💬 코멘트 시스템
 
@@ -146,6 +153,16 @@ src/components/Button.tsx:L42-L48   # 이 줄은 자동으로 추가됩니다
 이 부분은 불필요합니다
 ```
 
+## 🤖 에이전트에서 호출
+
+difit을 사용해 사용자에게 리뷰를 요청하는 Skill은 아래 명령으로 설치할 수 있습니다:
+
+```sh
+npx skills add yoshiko-pg/difit
+```
+
+에이전트가 코드를 수정한 뒤에는 difit 서버를 실행합니다.
+
 ## 🎨 구문 강조 언어
 
 - **JavaScript/TypeScript**: `.js`, `.jsx`, `.ts`, `.tsx`
@@ -201,10 +218,9 @@ pnpm run build
 # 테스트 실행
 pnpm test
 
-# 린트 및 포맷
-pnpm run lint
+# 타입체크와 lint와 포맷
+pnpm run check
 pnpm run format
-pnpm run typecheck
 ```
 
 ### 개발 워크플로우
@@ -218,17 +234,18 @@ pnpm run typecheck
 
 - **CLI**: 포괄적인 검증을 갖춘 Commander.js로 인수 구문 분석
 - **백엔드**: diff 처리를 위한 simple-git이 포함된 Express 서버
-- **GitHub 통합**: 자동 인증 (GitHub CLI + 환경 변수)을 갖춘 GitHub API용 Octokit
+- **GitHub 통합**: GitHub CLI(`gh pr diff --patch`) 기반 PR 패치 조회
 - **프론트엔드**: React 18 + TypeScript + Vite
 - **스타일링**: GitHub과 유사한 다크 테마를 갖춘 Tailwind CSS v4
 - **구문 강조**: 동적 언어 로딩을 갖춘 Prism.js
 - **테스트**: 동일 위치에 배치된 테스트 파일을 사용하는 Vitest 단위 테스트
-- **품질**: ESLint, Prettier, lefthook 사전 커밋 훅
+- **품질**: oxlint, oxfmt, lefthook 사전 커밋 훅
 
 ## 📋 요구 사항
 
 - Node.js ≥ 21.0.0
 - 검토할 커밋이 포함된 Git 저장소
+- `--pr` 모드 사용 시 GitHub CLI(`gh`)
 
 ## 📄 라이선스
 

package/README.md

@@ -25,6 +25,12 @@ npm install -g difit
 difit  # View the latest commit diff in WebUI
 ```
 
+Enable use from AI agents
+
+```bash
+npx skills add yoshiko-pg/difit # Add the Skill to your agent
+```
+
 ## 🚀 Usage
 
 ### Basic Usage
@@ -66,19 +72,19 @@ difit working  # Unstaged changes only
 difit --pr https://github.com/owner/repo/pull/123
 ```
 
-difit automatically handles GitHub authentication using:
+`--pr` mode fetches patches by running `gh pr diff --patch` under the hood.
+
+Authentication is handled by GitHub CLI:
 
-1. **GitHub CLI** (recommended): If you're logged in with `gh auth login`, difit uses your existing credentials
-2. **Environment Variable**: Set `GITHUB_TOKEN` environment variable
-3. **No Authentication**: Public repositories work without authentication (rate-limited)
+1. **Login once** (recommended): `gh auth login`
+2. **Token-based auth** (CI/non-interactive): set `GH_TOKEN` or `GITHUB_TOKEN`
 
 #### GitHub Enterprise Server
 
-For Enterprise Server PRs, you must set a token generated on YOUR Enterprise Server instance:
+For Enterprise Server PRs, authenticate GitHub CLI against your Enterprise host:
 
-1. Go to `https://YOUR-ENTERPRISE-SERVER/settings/tokens`
-2. Generate a personal access token with appropriate scopes
-3. Set it as `GITHUB_TOKEN` environment variable
+1. `gh auth login --hostname YOUR-ENTERPRISE-SERVER`
+2. Or set `GH_HOST=YOUR-ENTERPRISE-SERVER` with `GH_TOKEN`/`GITHUB_TOKEN`
 
 ### Stdin
 
@@ -121,6 +127,7 @@ Stdin mode is selected with intent-first rules:
 | `--tui`               | false     | Use terminal UI mode instead of WebUI                                      |
 | `--clean`             | false     | Clear all existing comments and viewed files on startup                    |
 | `--include-untracked` | false     | Automatically include untracked files in diff (only with `.` or `working`) |
+| `--keep-alive`        | false     | Keep server running after browser disconnects (stop manually with Ctrl+C)  |
 
 ## 💬 Comment System
 
@@ -146,6 +153,16 @@ src/components/Button.tsx:L42-L48   # This line is automatically added
 This section is unnecessary
 ```
 
+## 🤖 Calling from Agents
+
+You can install the following Skill to request reviews from users with difit.
+
+```sh
+npx skills add yoshiko-pg/difit
+```
+
+After an agent edits code, it will start the difit server.
+
 ## 🎨 Syntax Highlighting Languages
 
 - **JavaScript/TypeScript**: `.js`, `.jsx`, `.ts`, `.tsx`
@@ -201,10 +218,9 @@ pnpm run build
 # Run tests
 pnpm test
 
-# Lint and format
-pnpm run lint
+# Run typecheck, lint, and format
+pnpm run check
 pnpm run format
-pnpm run typecheck
 ```
 
 ### Development Workflow
@@ -218,17 +234,18 @@ pnpm run typecheck
 
 - **CLI**: Commander.js for argument parsing with comprehensive validation
 - **Backend**: Express server with simple-git for diff processing
-- **GitHub Integration**: Octokit for GitHub API with automatic authentication (GitHub CLI + env vars)
+- **GitHub Integration**: GitHub CLI (`gh pr diff --patch`) for PR patch retrieval
 - **Frontend**: React 18 + TypeScript + Vite
 - **Styling**: Tailwind CSS v4 with GitHub-like dark theme
 - **Syntax Highlighting**: Prism.js with dynamic language loading
 - **Testing**: Vitest for unit tests with co-located test files
-- **Quality**: ESLint, Prettier, lefthook pre-commit hooks
+- **Quality**: oxlint, oxfmt, lefthook pre-commit hooks
 
 ## 📋 Requirements
 
 - Node.js ≥ 21.0.0
 - Git repository with commits to review
+- GitHub CLI (`gh`) for `--pr` mode
 
 ## 📄 License
 

package/README.zh.md

@@ -25,6 +25,12 @@ npm install -g difit
 difit  # 在 WebUI 中查看最新提交的差异
 ```
 
+使其可供 AI 代理使用
+
+```bash
+npx skills add yoshiko-pg/difit # 为代理添加 Skill
+```
+
 ## 🚀 使用方法
 
 ### 基本用法
@@ -66,19 +72,19 @@ difit working  # 仅未暂存的更改
 difit --pr https://github.com/owner/repo/pull/123
 ```
 
-difit 使用以下方式自动处理 GitHub 认证：
+`--pr` 模式会在内部执行 `gh pr diff --patch` 来获取补丁。
+
+认证由 GitHub CLI 处理：
 
-1. **GitHub CLI**（推荐）：如果您已使用 `gh auth login` 登录，difit 将使用您现有的凭据
-2. **环境变量**：设置 `GITHUB_TOKEN` 环境变量
-3. **无认证**：公共仓库无需认证即可工作（有速率限制）
+1. **先登录一次**（推荐）：`gh auth login`
+2. **令牌认证**（CI/非交互环境）：设置 `GH_TOKEN` 或 `GITHUB_TOKEN`
 
 #### GitHub Enterprise Server
 
-对于 Enterprise Server PR，您必须设置在您的 Enterprise Server 实例上生成的令牌：
+对于 Enterprise Server PR，请先让 GitHub CLI 认证到 Enterprise 主机：
 
-1. 转到 `https://YOUR-ENTERPRISE-SERVER/settings/tokens`
-2. 生成具有适当范围的个人访问令牌
-3. 将其设置为 `GITHUB_TOKEN` 环境变量
+1. `gh auth login --hostname YOUR-ENTERPRISE-SERVER`
+2. 或设置 `GH_HOST=YOUR-ENTERPRISE-SERVER`，并配置 `GH_TOKEN` / `GITHUB_TOKEN`
 
 ### 标准输入
 
@@ -121,6 +127,7 @@ git diff --cached | difit -
 | `--tui`               | false     | 使用终端 UI 模式而不是 WebUI                                           |
 | `--clean`             | false     | 启动时清除所有现有评论和已查看的文件                                   |
 | `--include-untracked` | false     | 自动将 untracked 文件包含在 diff 中（仅在 `.` 或 `working` 时有效）    |
+| `--keep-alive`        | false     | 浏览器断开后保持服务器运行（使用 Ctrl+C 手动停止）                     |
 
 ## 💬 评论系统
 
@@ -146,6 +153,16 @@ src/components/Button.tsx:L42-L48   # 此行自动添加
 此部分是不必要的
 ```
 
+## 🤖 从代理调用
+
+你可以通过以下命令安装 Skill，以便使用 difit 向用户请求审查：
+
+```sh
+npx skills add yoshiko-pg/difit
+```
+
+代理编辑代码后，将会启动 difit 服务器。
+
 ## 🎨 语法高亮语言
 
 - **JavaScript/TypeScript**：`.js`, `.jsx`, `.ts`, `.tsx`
@@ -201,10 +218,9 @@ pnpm run build
 # 运行测试
 pnpm test
 
-# 代码检查和格式化
-pnpm run lint
+# 运行 typecheck、lint 和格式化
+pnpm run check
 pnpm run format
-pnpm run typecheck
 ```
 
 ### 开发工作流程
@@ -218,17 +234,18 @@ pnpm run typecheck
 
 - **CLI**：使用 Commander.js 进行参数解析，具有全面的验证
 - **后端**：Express 服务器配合 simple-git 进行差异处理
-- **GitHub 集成**：Octokit 用于 GitHub API，具有自动认证（GitHub CLI + 环境变量）
+- **GitHub 集成**：使用 GitHub CLI（`gh pr diff --patch`）获取 PR 补丁
 - **前端**：React 18 + TypeScript + Vite
 - **样式**：Tailwind CSS v4，带有类似 GitHub 的深色主题
 - **语法高亮**：Prism.js 带动态语言加载
 - **测试**：Vitest 用于单元测试，测试文件与源代码放在一起
-- **质量**：ESLint、Prettier、lefthook 预提交钩子
+- **质量**：oxlint、oxfmt、lefthook 预提交钩子
 
 ## 📋 要求
 
 - Node.js ≥ 21.0.0
 - 包含要审查的提交的 Git 仓库
+- 使用 `--pr` 模式时需要 GitHub CLI（`gh`）
 
 ## 📄 许可证
 

package/dist/cli/index.js

@@ -6,7 +6,7 @@ import pkg from '../../package.json' with { type: 'json' };
 import { startServer } from '../server/server.js';
 import { DiffMode } from '../types/watch.js';
 import { DEFAULT_DIFF_VIEW_MODE, normalizeDiffViewMode } from '../utils/diffMode.js';
-import { shouldReadStdin, findUntrackedFiles, markFilesIntentToAdd, promptUser, validateDiffArguments, resolvePrCommits, getGitRoot, } from './utils.js';
+import { shouldReadStdin, findUntrackedFiles, markFilesIntentToAdd, promptUser, validateDiffArguments, getPrPatch, getGitRoot, } from './utils.js';
 function isSpecialArg(arg) {
     return arg === 'working' || arg === 'staged' || arg === '.';
 }
@@ -32,7 +32,7 @@ const program = new Command();
 program
     .name('difit')
     .description('A lightweight Git diff viewer with GitHub-like interface')
-    .version(pkg.version)
+    .version(pkg.version, '-v, --version', 'output the version number')
     .argument('[commit-ish]', 'Git commit, tag, branch, HEAD~n reference, or "working"/"staged"/"."', 'HEAD')
     .argument('[compare-with]', 'Optional: Compare with this commit/branch (shows diff between commit-ish and compare-with)')
     .option('--port <port>', 'preferred port (auto-assigned if occupied)', parseInt)
@@ -43,33 +43,62 @@ program
     .option('--pr <url>', 'GitHub PR URL to review (e.g., https://github.com/owner/repo/pull/123)')
     .option('--clean', 'start with a clean slate by clearing all existing comments')
     .option('--include-untracked', 'automatically include untracked files in diff')
+    .option('--keep-alive', 'keep server running even after browser disconnects')
     .action(async (commitish, compareWith, options) => {
     try {
-        // Check if we should read from stdin
-        const readFromStdin = shouldReadStdin({
-            commitish,
-            hasPositionalArgs: program.args.length > 0,
-            hasPrOption: Boolean(options.pr),
-            hasTuiOption: Boolean(options.tui),
-        });
-        if (readFromStdin) {
-            // Read unified diff from stdin
-            const diffContent = await readStdin();
-            if (!diffContent.trim()) {
-                console.error('Error: No diff content received from stdin');
+        let stdinDiff;
+        let stdinReviewLabel = 'diff from stdin';
+        if (options.pr) {
+            if (commitish !== 'HEAD' || compareWith) {
+                console.error('Error: --pr option cannot be used with positional arguments');
                 process.exit(1);
             }
-            // Start server with stdin diff
+            if (options.tui) {
+                console.error('Error: --pr option cannot be used with --tui');
+                process.exit(1);
+            }
+            try {
+                stdinDiff = getPrPatch(options.pr);
+                stdinReviewLabel = options.pr;
+            }
+            catch (error) {
+                console.error(`Error resolving PR: ${error instanceof Error ? error.message : 'Unknown error'}`);
+                process.exit(1);
+            }
+        }
+        else {
+            // Check if we should read from stdin
+            const readFromStdin = shouldReadStdin({
+                commitish,
+                hasPositionalArgs: program.args.length > 0,
+                hasPrOption: false,
+                hasTuiOption: Boolean(options.tui),
+            });
+            if (readFromStdin) {
+                // Read unified diff from stdin
+                stdinDiff = await readStdin();
+                if (!stdinDiff.trim()) {
+                    console.error('Error: No diff content received from stdin');
+                    process.exit(1);
+                }
+            }
+        }
+        if (stdinDiff) {
+            // Start server with stdin diff (including --pr patch)
             const { url } = await startServer({
-                stdinDiff: diffContent,
+                stdinDiff,
                 preferredPort: options.port,
                 host: options.host,
                 openBrowser: options.open,
                 mode: options.mode,
                 clearComments: options.clean,
+                keepAlive: options.keepAlive,
             });
             console.log(`\n🚀 difit server started on ${url}`);
-            console.log(`📋 Reviewing: diff from stdin`);
+            console.log(`📋 Reviewing: ${stdinReviewLabel}`);
+            if (options.keepAlive) {
+                console.log('🔒 Keep-alive mode: server will stay running after browser disconnects');
+            }
             console.log('\nPress Ctrl+C to stop the server');
             return;
         }
@@ -85,26 +114,7 @@ program
         // Determine target and base commitish
         let targetCommitish = commitish;
         let baseCommitish;
-        // Handle PR URL option
-        if (options.pr) {
-            if (commitish !== 'HEAD' || compareWith) {
-                console.error('Error: --pr option cannot be used with positional arguments');
-                process.exit(1);
-            }
-            try {
-                const prCommits = await resolvePrCommits(options.pr);
-                targetCommitish = prCommits.targetCommitish;
-                baseCommitish = prCommits.baseCommitish;
-                console.log(`📋 Reviewing PR: ${options.pr}`);
-                console.log(`🎯 Target commit: ${targetCommitish.substring(0, 7)}`);
-                console.log(`📍 Base commit: ${baseCommitish.substring(0, 7)}`);
-            }
-            catch (error) {
-                console.error(`Error resolving PR: ${error instanceof Error ? error.message : 'Unknown error'}`);
-                process.exit(1);
-            }
-        }
-        else if (compareWith) {
+        if (compareWith) {
             // If compareWith is provided, use it as base
             baseCommitish = compareWith;
         }
@@ -143,15 +153,11 @@ program
             }));
             return;
         }
-        // Skip validation for PR URLs as they're already resolved to valid commits
-        if (!options.pr) {
-            const validation = validateDiffArguments(targetCommitish, compareWith);
-            if (!validation.valid) {
-                console.error(`Error: ${validation.error}`);
-                process.exit(1);
-            }
+        const validation = validateDiffArguments(targetCommitish, compareWith);
+        if (!validation.valid) {
+            console.error(`Error: ${validation.error}`);
+            process.exit(1);
         }
-        const diffMode = determineDiffMode(targetCommitish, compareWith);
         const { url, port, isEmpty } = await startServer({
             targetCommitish,
             baseCommitish,
@@ -160,11 +166,15 @@ program
             openBrowser: options.open,
             mode: options.mode,
             clearComments: options.clean,
-            diffMode,
+            keepAlive: options.keepAlive,
+            diffMode: determineDiffMode(targetCommitish, compareWith),
             repoPath,
         });
         console.log(`\n🚀 difit server started on ${url}`);
         console.log(`📋 Reviewing: ${targetCommitish}`);
+        if (options.keepAlive) {
+            console.log('🔒 Keep-alive mode: server will stay running after browser disconnects');
+        }
         if (options.clean) {
             console.log('🧹 Starting with a clean slate - all existing comments will be cleared');
         }