# pi-issue-runner

> GitHub IssueからGit worktreeを作成し、tmuxセッション内で別のpiインスタンスを起動してタスクを実行します。並列開発に最適。

- Author: takemo-chan
- Repository: takemo101/pi-issue-runner
- Version: 20260131230547
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/takemo101/pi-issue-runner
- Web: https://mule.run/skillshub/@@takemo101/pi-issue-runner~pi-issue-runner:20260131230547

---

---
name: pi-issue-runner
description: GitHub IssueからGit worktreeを作成し、tmuxセッション内で別のpiインスタンスを起動してタスクを実行します。並列開発に最適。
---

# Pi Issue Runner

GitHub Issueを入力として、Git worktreeを作成し、tmuxセッション内で独立したpiインスタンスを起動します。

## クイックリファレンス

```bash
# Issue実行（メインコマンド）
# デフォルトでpi終了後に自動クリーンアップ
scripts/run.sh <issue-number> [options]

Options:
  -w, --workflow <name>  ワークフロー名（デフォルト: default）
  --list-workflows       利用可能なワークフロー一覧を表示
  --no-attach            バックグラウンドで起動
  --no-cleanup           自動クリーンアップを無効化
  --reattach             既存セッションにアタッチ
  --force                強制再作成
  -b, --branch <name>    カスタムブランチ名
  --base <branch>        ベースブランチ
  --pi-args <args>       piへの追加引数

# セッション管理
scripts/list.sh              # セッション一覧
scripts/attach.sh <session>  # セッションにアタッチ
scripts/status.sh <session>  # 状態確認
scripts/stop.sh <session>    # セッション停止
scripts/cleanup.sh <session> # 手動クリーンアップ

# 継続的改善
scripts/improve.sh                    # レビュー→Issue作成→実行→待機のループ
scripts/improve.sh --dry-run          # レビューのみ（Issue作成しない）
scripts/improve.sh --review-only      # 問題表示のみ
scripts/improve.sh --max-iterations 2 # 最大2回繰り返す
scripts/improve.sh --auto-continue    # 自動継続（承認スキップ）
scripts/wait-for-sessions.sh 42 43    # 複数セッション完了待機
```

## 前提条件

- `gh` (GitHub CLI、認証済み)
- `tmux`
- `pi`
- `jq` (JSON処理)
- `yq` (オプション - ワークフローのカスタマイズに必要)

## 自動クリーンアップ

タスク完了時にAIが `###TASK_COMPLETE_<issue_number>###` マーカーを出力すると、
`watch-session.sh` が検出して自動的にクリーンアップを実行します。

### 動作フロー

1. `run.sh` がバックグラウンドで `watch-session.sh` を起動
2. `watch-session.sh` がtmuxセッションの出力を監視
3. 完了マーカー（例: `###TASK_COMPLETE_42###`）を検出
4. 自動的に `cleanup.sh` を実行してworktreeとセッションを削除

### 自動クリーンアップの無効化

```bash
# 自動クリーンアップを無効化
scripts/run.sh 42 --no-cleanup
```

## 詳細ドキュメント

詳しい使い方、設定、トラブルシューティングは [README.md](README.md) を参照してください。