npm - @claudetree/cli - Versions diffs - 0.5.3 → 0.5.4 - Mend

@claudetree/cli 0.5.3 → 0.5.4

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.

Files changed (4) hide show

package/README.ja.md CHANGED Viewed

@@ -5,83 +5,133 @@
   <a href="README.zh.md">中文</a>
 </p>
+<p align="center">
+  <a href="https://www.npmjs.com/package/@claudetree/cli"><img src="https://img.shields.io/npm/v/@claudetree/cli.svg" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@claudetree/cli"><img src="https://img.shields.io/npm/dm/@claudetree/cli.svg" alt="npm downloads"></a>
+  <a href="https://github.com/wonjangcloud9/claude-tree/actions/workflows/ci.yml"><img src="https://github.com/wonjangcloud9/claude-tree/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <img src="https://img.shields.io/badge/node-%3E%3D22-brightgreen" alt="node version">
+</p>
 # @claudetree/cli
-**複数のClaude Codeセッションを並列実行** — それぞれ独立したgit worktreeで動作します。
+**GitHub Issue URL -> 自律的な実装 -> Pull Request。手動介入ゼロ。**
+claudetreeは複数のClaude Codeセッションを並列実行し、それぞれ独立したgit worktreeで動作します。GitHub Issueを渡して放置するだけで、PRが完成します。
+## Claude Codeにできないこと（claudetreeなら可能）
+| 機能 | Claude Code | claudetree |
+|------|-------------|------------|
+| 並列セッション | 一度に1つだけ | 無制限 |
+| Issue-to-PRパイプライン | 手動コピペ | `ct start <url>` |
+| セッションコスト追跡 | 現セッションのみ | セッション別 + 合計 |
+| バッチIssue処理 | 非対応 | `ct batch` / `ct auto` |
+| 依存チェーン | 非対応 | `ct chain` |
+| Webダッシュボード | 非対応 | `ct web` |
+| セッションログ | ターミナルをスクロール | `ct log <id>` |
 ## インストール
 ```bash
 npm install -g @claudetree/cli
-# または
-pnpm add -g @claudetree/cli
 ```
-## クイックスタート
+必要環境: Node.js >= 22, Git, [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)
+## 60秒クイックスタート
 ```bash
-# プロジェクトで初期化
+# 1. プロジェクトで初期化
 ct init
-# GitHub課題の作業開始（TDDモードがデフォルト）
-ct start https://github.com/you/repo/issues/42
+# 2. 環境チェック
+ct doctor
-# 進捗監視
-ct status
+# 3. Fire and forget — Claudeが残りを処理
+ct start https://github.com/you/repo/issues/42
-# Webダッシュボードを開く
-ct web
+# 4. モニタリング
+ct status          # ターミナルで概要確認
+ct log abc123      # セッションイベントログ
+ct web             # Webダッシュボード
 ```
-## TDDモード（デフォルト）
+## コアワークフロー
+### 単一Issue
+```bash
+ct start 42                              # Issue番号で指定
+ct start https://github.com/org/repo/issues/42  # URLで指定
+ct start "fix the login bug"             # 説明文で指定
+```
-すべてのセッションはデフォルトでTDDモードで実行されます：
+### バッチ処理
 ```bash
-# TDDモード（2時間タイムアウト、デフォルト）
-ct start 42
+# 手動: 対象Issueを指定
+ct batch 101 102 103
+ct batch --label bug --limit 10
-# カスタムタイムアウトとゲート
-ct start 42 --timeout 60 --gates test,type,lint
+# 自動: open Issueを取得し、コンフリクト検知付きで実行
+ct auto
+ct auto --label "high-priority" --dry-run
+```
+### 依存チェーン
-# TDDモードを無効化
-ct start 42 --no-tdd
+```bash
+# 順序実行: DBスキーマ -> API -> UI
+ct chain 10 11 12
 ```
-**TDDオプション：**
-- `--timeout <分>` - セッションタイムアウト（デフォルト：120）
-- `--idle-timeout <分>` - アイドルタイムアウト（デフォルト：10）
-- `--gates <gates>` - 検証ゲート：test,type,lint,build（デフォルト：test,type）
-- `--max-retries <n>` - ゲートリトライ回数（デフォルト：3）
-- `--no-tdd` - TDDモード無効化
+### コスト追跡
+```bash
+# セッションごとの予算上限を設定
+ct start 42 --max-cost 5.00
+# 分析レポートを表示
+ct stats
+# ステータスでセッション別コストを確認
+ct status
+```
 ## コマンド
 | コマンド | 説明 |
 |----------|------|
-| `ct init` | プロジェクトにclaudetree初期化 |
-| `ct start <issue>` | Worktree作成とClaudeセッション開始 |
-| `ct status` | すべてのセッションステータス表示 |
-| `ct stop [id]` | セッション停止 |
-| `ct doctor` | 環境ヘルスチェック |
-| `ct demo` | インタラクティブデモ（トークン不使用） |
-| `ct batch` | 複数の課題を並列処理 |
-| `ct bustercall` | すべてのopen課題を自動取得して並列セッション実行 |
-| `ct clean` | すべてのworktreeを削除（main以外） |
-| `ct web` | Webダッシュボード開始 |
-## 主な機能
-- **マルチセッション**: 無制限のClaudeセッションを並列実行
-- **独立ワークスペース**: 各タスクは独自のgit worktreeを持つ
-- **Fire and Forget**: GitHub課題URLを渡すとClaudeが残りを処理
-- **トークン追跡**: 各セッションが使用するトークンを正確に確認
-- **Webダッシュボード**: すべてのセッションをリアルタイム監視
+| `ct init` | プロジェクトにclaudetreeを初期化 |
+| `ct start <issue>` | GitHub Issueに対してClaudeセッションを開始 |
+| `ct status` | 全セッションのステータスとコストを表示 |
+| `ct stats` | セッション分析: コスト、トークン、成功率 |
+| `ct log <session>` | セッションイベントを表示（-f でフォロー可能） |
+| `ct stop [id]` | 実行中のセッションを停止 |
+| `ct resume <id>` | 一時停止中のセッションを再開 |
+| `ct batch [issues]` | 複数Issueを並列処理 |
+| `ct auto` | open Issueを自動取得し、コンフリクト検知付きで実行 |
+| `ct chain [issues]` | Issueを順序実行（依存関係順） |
+| `ct web` | Webダッシュボードを起動（localhost:3000） |
+| `ct list` | 全worktreeを一覧表示 |
+| `ct clean` | 完了済みworktreeを削除 |
+| `ct doctor` | 環境チェック: Node, Git, Claude CLI |
+## TDDモード（デフォルト）
+全セッションはデフォルトでテスト駆動開発を適用します:
+```bash
+ct start 42                          # TDDモード（2時間タイムアウト）
+ct start 42 --gates test,type,lint   # 検証ゲートをカスタマイズ
+ct start 42 --no-tdd                 # TDDモードを無効化
+```
 ## リンク
-- [GitHubリポジトリ](https://github.com/wonjangcloud9/claude-tree)
+- [GitHub](https://github.com/wonjangcloud9/claude-tree)
 - [完全ドキュメント](https://github.com/wonjangcloud9/claude-tree#readme)
+- [変更履歴](https://github.com/wonjangcloud9/claude-tree/blob/develop/CHANGELOG.md)
 ## ライセンス

package/README.ko.md CHANGED Viewed

@@ -5,106 +5,133 @@
   <a href="README.zh.md">中文</a>
 </p>
+<p align="center">
+  <a href="https://www.npmjs.com/package/@claudetree/cli"><img src="https://img.shields.io/npm/v/@claudetree/cli.svg" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@claudetree/cli"><img src="https://img.shields.io/npm/dm/@claudetree/cli.svg" alt="npm downloads"></a>
+  <a href="https://github.com/wonjangcloud9/claude-tree/actions/workflows/ci.yml"><img src="https://github.com/wonjangcloud9/claude-tree/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <img src="https://img.shields.io/badge/node-%3E%3D22-brightgreen" alt="node version">
+</p>
 # @claudetree/cli
-**여러 Claude Code 세션을 병렬로 실행** — 각각 독립된 git worktree에서 동작합니다.
+**GitHub Issue URL -> 자율 구현 -> Pull Request.** 수동 개입 제로.
+claudetree는 여러 Claude Code 세션을 병렬로 실행합니다. 각 세션은 독립된 git worktree에서 동작합니다. GitHub 이슈를 넘기고, 자리를 비운 뒤, 돌아오면 PR이 올라와 있습니다.
+## Claude Code가 못 하는 것 (claudetree는 가능)
+| 기능 | Claude Code | claudetree |
+|------|-------------|------------|
+| 병렬 세션 | 한 번에 하나 | 무제한 |
+| 이슈-to-PR 파이프라인 | 수동 복사-붙여넣기 | `ct start <url>` |
+| 세션 비용 추적 | 현재 세션만 | 세션별 + 합계 |
+| 이슈 일괄 처리 | 불가 | `ct batch` / `ct auto` |
+| 의존성 체인 | 불가 | `ct chain` |
+| 웹 대시보드 | 불가 | `ct web` |
+| 세션 로그 | 터미널 스크롤 | `ct log <id>` |
 ## 설치
 ```bash
 npm install -g @claudetree/cli
-# 또는
-pnpm add -g @claudetree/cli
 ```
-## 빠른 시작
+필수 요구사항: Node.js >= 22, Git, [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)
+## 60초 빠른 시작
 ```bash
-# 프로젝트에서 초기화
+# 1. 프로젝트에서 초기화
 ct init
-# GitHub 이슈 작업 시작 (TDD 모드 기본)
+# 2. 환경 확인
+ct doctor
+# 3. Fire and forget -- Claude가 나머지를 처리
 ct start https://github.com/you/repo/issues/42
-# 또는 자연어로
-ct start "로그인 버그 수정해줘"
+# 4. 모니터링
+ct status          # 터미널에서 전체 현황
+ct log abc123      # 세션 이벤트 로그
+ct web             # 웹 대시보드
+```
-# 진행상황 모니터링
-ct status
+## 핵심 워크플로우
-# 웹 대시보드 열기
-ct web
-```
+### 단일 이슈
-## TDD 모드 (기본)
+```bash
+ct start 42                              # 이슈 번호로
+ct start https://github.com/org/repo/issues/42  # URL로
+ct start "로그인 버그 수정해줘"             # 자연어로
+```
-모든 세션은 기본적으로 TDD 모드로 실행됩니다:
+### 배치 처리
 ```bash
-# TDD 모드 (2시간 타임아웃, 기본값)
-ct start 42
+# 수동: 이슈를 직접 지정
+ct batch 101 102 103
+ct batch --label bug --limit 10
+# 자동: 열린 이슈를 가져와 충돌 감지 후 병렬 실행
+ct auto                          # bustercall 별칭
+ct auto --label "high-priority" --dry-run
+```
-# 커스텀 타임아웃 및 게이트
-ct start 42 --timeout 60 --gates test,type,lint
+### 의존성 체인
-# TDD 모드 끄기
-ct start 42 --no-tdd
+```bash
+# 순차 실행: DB 스키마 -> API -> UI
+ct chain 10 11 12
 ```
-**TDD 옵션:**
-- `--timeout <분>` - 세션 타임아웃 (기본: 120)
-- `--idle-timeout <분>` - 유휴 타임아웃 (기본: 10)
-- `--gates <gates>` - 검증 게이트: test,type,lint,build (기본: test,type)
-- `--max-retries <n>` - 게이트 재시도 횟수 (기본: 3)
-- `--no-tdd` - TDD 모드 비활성화
+### 비용 추적
+```bash
+# 세션당 예산 한도 설정
+ct start 42 --max-cost 5.00
+# 통계 확인
+ct stats
+# 상태에서 세션별 비용 확인
+ct status
+```
 ## 명령어
 | 명령어 | 설명 |
 |--------|------|
+| `ct start <issue>` | GitHub 이슈에 대해 Claude 세션 시작 |
+| `ct status` | 모든 세션 상태 및 비용 표시 |
+| `ct stats` | 세션 통계: 비용, 토큰, 성공률 |
+| `ct log <session>` | 세션 이벤트 조회 (-f 옵션으로 실시간 추적) |
+| `ct stop [id]` | 실행 중인 세션 중지 |
+| `ct resume <id>` | 일시 중단된 세션 재개 |
+| `ct batch [issues]` | 여러 이슈를 병렬로 처리 |
+| `ct auto` | 열린 이슈 자동 수집 및 충돌 감지 실행 |
+| `ct chain [issues]` | 이슈를 순차 실행 (의존성 순서) |
+| `ct web` | 웹 대시보드 실행 (localhost:3000) |
+| `ct list` | 모든 worktree 목록 표시 |
+| `ct clean` | 완료된 worktree 제거 |
+| `ct doctor` | 환경 확인: Node, Git, Claude CLI |
 | `ct init` | 프로젝트에 claudetree 초기화 |
-| `ct start <issue>` | Worktree 생성 및 Claude 세션 시작 |
-| `ct status` | 모든 세션 상태 표시 |
-| `ct stop [id]` | 세션 중지 |
-| `ct doctor` | 환경 상태 확인 |
-| `ct demo` | 인터랙티브 데모 (토큰 미사용) |
-| `ct batch` | 여러 이슈를 병렬로 처리 |
-| `ct bustercall` | 모든 open 이슈를 자동으로 가져와 병렬 세션 실행 |
-| `ct clean` | 모든 worktree 제거 (main 제외) |
-| `ct web` | 웹 대시보드 시작 |
-## Bustercall (일괄 처리)
+## TDD 모드 (기본)
-스마트 충돌 감지로 여러 GitHub 이슈를 병렬 처리:
+모든 세션은 기본적으로 테스트 주도 개발 방식으로 실행됩니다:
 ```bash
-# 처리될 이슈 미리보기
-ct bustercall --dry-run
-# 기본 설정으로 실행 (3개 병렬)
-ct bustercall
-# 순차 실행 강제
-ct bustercall --sequential
-# 커스텀 충돌 라벨
-ct bustercall --conflict-labels "deps,config"
+ct start 42                          # TDD, 2시간 타임아웃
+ct start 42 --gates test,type,lint   # 커스텀 검증 게이트
+ct start 42 --no-tdd                 # TDD 비활성화
 ```
-**충돌 감지:** 공유 파일(package.json, config)을 수정할 수 있는 이슈는 자동 감지되어 머지 충돌 방지를 위해 순차 실행됩니다.
-## 주요 기능
-- **멀티 세션**: 무제한 Claude 세션 병렬 실행
-- **독립 워크스페이스**: 각 작업은 고유한 git worktree 보유
-- **Fire and Forget**: GitHub 이슈 URL 전달하면 Claude가 나머지 처리
-- **토큰 추적**: 각 세션이 사용하는 토큰 정확히 확인
-- **웹 대시보드**: 모든 세션을 실시간으로 모니터링
 ## 링크
-- [GitHub 저장소](https://github.com/wonjangcloud9/claude-tree)
+- [GitHub](https://github.com/wonjangcloud9/claude-tree)
 - [전체 문서](https://github.com/wonjangcloud9/claude-tree#readme)
+- [변경 내역](https://github.com/wonjangcloud9/claude-tree/blob/develop/CHANGELOG.md)
 ## 라이선스

package/README.zh.md CHANGED Viewed

@@ -5,83 +5,133 @@
   <a href="README.zh.md">中文</a>
 </p>
+<p align="center">
+  <a href="https://www.npmjs.com/package/@claudetree/cli"><img src="https://img.shields.io/npm/v/@claudetree/cli.svg" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@claudetree/cli"><img src="https://img.shields.io/npm/dm/@claudetree/cli.svg" alt="npm downloads"></a>
+  <a href="https://github.com/wonjangcloud9/claude-tree/actions/workflows/ci.yml"><img src="https://github.com/wonjangcloud9/claude-tree/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <img src="https://img.shields.io/badge/node-%3E%3D22-brightgreen" alt="node version">
+</p>
 # @claudetree/cli
-**并行运行多个Claude Code会话** — 每个会话在独立的git worktree中运行。
+**GitHub Issue URL -> 自主实现 -> Pull Request。零人工干预。**
+claudetree 可并行运行多个 Claude Code 会话，每个会话在独立的 git worktree 中运行。传入 GitHub Issue，离开，回来后即可获得 PR。
+## Claude Code做不到的（claudetree可以）
+| 能力 | Claude Code | claudetree |
+|------|-------------|------------|
+| 并行会话 | 一次只能一个 | 无限制 |
+| Issue到PR流水线 | 手动复制粘贴 | `ct start <url>` |
+| 会话成本追踪 | 仅当前会话 | 单会话 + 总计 |
+| 批量Issue处理 | 不支持 | `ct batch` / `ct auto` |
+| 依赖链 | 不支持 | `ct chain` |
+| Web仪表板 | 不支持 | `ct web` |
+| 会话日志 | 翻滚终端 | `ct log <id>` |
 ## 安装
 ```bash
 npm install -g @claudetree/cli
-# 或
-pnpm add -g @claudetree/cli
 ```
-## 快速开始
+需要: Node.js >= 22, Git, [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)
+## 60秒快速开始
 ```bash
-# 在项目中初始化
+# 1. 在项目中初始化
 ct init
-# 开始处理GitHub问题（默认TDD模式）
-ct start https://github.com/you/repo/issues/42
+# 2. 验证环境
+ct doctor
-# 监控进度
-ct status
+# 3. 即发即忘 - Claude处理其余
+ct start https://github.com/you/repo/issues/42
-# 打开Web仪表板
-ct web
+# 4. 监控
+ct status          # 终端概览
+ct log abc123      # 会话事件日志
+ct web             # Web仪表板
 ```
-## TDD模式（默认）
+## 核心工作流
+### 单个Issue
+```bash
+ct start 42                              # 按Issue编号
+ct start https://github.com/org/repo/issues/42  # 按URL
+ct start "fix the login bug"             # 按描述
+```
-所有会话默认以TDD模式运行：
+### 批量处理
 ```bash
-# TDD模式（2小时超时，默认）
-ct start 42
+# 手动指定Issue
+ct batch 101 102 103
+ct batch --label bug --limit 10
+# 自动: 获取所有open Issue，智能冲突检测
+ct auto                          # bustercall的别名
+ct auto --label "high-priority" --dry-run
+```
-# 自定义超时和验证门
-ct start 42 --timeout 60 --gates test,type,lint
+### 依赖链
-# 禁用TDD模式
-ct start 42 --no-tdd
+```bash
+# 按顺序运行: 数据库Schema -> API -> UI
+ct chain 10 11 12
 ```
-**TDD选项：**
-- `--timeout <分钟>` - 会话超时（默认：120）
-- `--idle-timeout <分钟>` - 空闲超时（默认：10）
-- `--gates <gates>` - 验证门：test,type,lint,build（默认：test,type）
-- `--max-retries <n>` - 门重试次数（默认：3）
-- `--no-tdd` - 禁用TDD模式
+### 成本追踪
+```bash
+# 为每个会话设置预算上限
+ct start 42 --max-cost 5.00
+# 查看分析数据
+ct stats
+# 在状态中查看单会话成本
+ct status
+```
 ## 命令
 | 命令 | 描述 |
 |------|------|
 | `ct init` | 在项目中初始化claudetree |
-| `ct start <issue>` | 创建Worktree并启动Claude会话 |
-| `ct status` | 显示所有会话状态 |
-| `ct stop [id]` | 停止会话 |
-| `ct doctor` | 检查环境健康状态 |
-| `ct demo` | 交互式演示（不消耗token） |
-| `ct batch` | 并行处理多个问题 |
-| `ct bustercall` | 自动获取所有open问题并运行并行会话 |
-| `ct clean` | 删除所有worktree（main除外） |
-| `ct web` | 启动Web仪表板 |
-## 主要功能
-- **多会话**: 无限并行运行Claude会话
-- **隔离工作空间**: 每个任务都有自己的git worktree
-- **即发即忘**: 传递GitHub问题URL，Claude处理其余
-- **Token追踪**: 准确查看每个会话使用的token数量
-- **Web仪表板**: 实时监控所有会话
+| `ct start <issue>` | 为GitHub Issue启动Claude会话 |
+| `ct status` | 显示所有会话状态及成本 |
+| `ct stats` | 会话分析: 成本、token、成功率 |
+| `ct log <session>` | 查看会话事件（支持 -f 跟踪） |
+| `ct stop [id]` | 停止运行中的会话 |
+| `ct resume <id>` | 恢复暂停的会话 |
+| `ct batch [issues]` | 并行处理多个Issue |
+| `ct auto` | 自动获取Issue并检测冲突 |
+| `ct chain [issues]` | 按顺序运行Issue（依赖顺序） |
+| `ct web` | 在 localhost:3000 启动Web仪表板 |
+| `ct list` | 列出所有worktree |
+| `ct clean` | 删除已完成的worktree |
+| `ct doctor` | 检查环境: Node, Git, Claude CLI |
+## TDD模式
+所有会话默认启用测试驱动开发:
+```bash
+ct start 42                          # TDD模式，2小时超时
+ct start 42 --gates test,type,lint   # 自定义验证门
+ct start 42 --no-tdd                 # 禁用TDD
+```
 ## 链接
-- [GitHub仓库](https://github.com/wonjangcloud9/claude-tree)
+- [GitHub](https://github.com/wonjangcloud9/claude-tree)
 - [完整文档](https://github.com/wonjangcloud9/claude-tree#readme)
+- [更新日志](https://github.com/wonjangcloud9/claude-tree/blob/develop/CHANGELOG.md)
 ## 许可证

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@claudetree/cli",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "description": "Issue-to-PR automation: parallel Claude Code sessions with cost tracking, batch processing & web dashboard",
   "type": "module",
   "bin": {
@@ -36,8 +36,8 @@
   "dependencies": {
     "async-mutex": "^0.5.0",
     "commander": "^14.0.2",
-    "@claudetree/core": "0.5.3",
-    "@claudetree/shared": "0.5.3"
+    "@claudetree/core": "0.5.4",
+    "@claudetree/shared": "0.5.4"
   },
   "devDependencies": {
     "@types/node": "^25.0.3",