worktree

変更前

worktreeセッションでは、.claude/skills がGitの追跡対象外であると、メインリポジトリのプロジェクトスキルが読み込まれず、スキルが利用できない状態だった。

変更後

worktreeセッションでもメインリポジトリのプロジェクトスキル(.claude/skills 配下)が読み込まれるようになり、スキルが利用可能になった。

ユーザーへの恩恵

worktreeで作業する場合でも、.claude/skills をわざわざ追跡対象にコミットすることなく、メインリポジトリのプロジェクトスキルをそのまま利用できる。

変更前

worktree分離されたセッションが、特定のネストしたシェル展開を含むBashコマンドを受け入れていた。

変更後

Bashコマンド内に特定の形のネストしたシェル展開が含まれている場合、worktree分離されたセッションがそのコマンドを拒否するようになった。

ユーザーへの恩恵

worktree分離されたセッションであっても、シェル展開によって本来ブロックされるべきBashコマンドがメインチェックアウトに影響を与えるのを防げるようになる。

変更前

エージェントの worktree を削除する前の安全確認が、サブモジュールの checkout の存在を考慮するようになった。サブモジュールの checkout を含む worktree は、削除によって失うものが通常の worktree より大きいため、より慎重な条件で削除可否が判断される。

変更後

エージェントの worktree を削除する前の安全確認は、サブモジュールの checkout が含まれているかどうかを考慮していなかった。サブモジュールの checkout を含む worktree でも、通常の worktree と同じ条件で削除が進んでしまうことがあった。

ユーザーへの恩恵

サブモジュールの checkout を含む worktree でも、削除による意図しないデータ損失のリスクが減る。

変更前

.claude/scheduled_tasks.json を別のフォルダー(新しい worktree など)にコピーすると、保存済みの予約タスクが誤ったセッションで実行されていた。

変更後

Claude Code は、.claude/scheduled_tasks.json が別のフォルダー(新しい worktree など)にコピーされた場合でも、保存済みの予約タスクを元のセッションに紐付けて実行するようになった。

ユーザーへの恩恵

worktree を分けて作業しても、予約タスクが正しいセッションで動くようになる。

変更前

worktreeが削除できない場合、セッション削除が途中で止まり、原因と対処法がメッセージに表示されなかった

変更後

セッション削除時に削除できないworktreeに遭遇すると、メッセージが原因と次のステップを具体的に表示するようになった

ユーザーへの恩恵

削除できない理由と対処方法がわかるため、ユーザーはメッセージの指示に従って問題を解決できる

変更前

大規模リポジトリで --worktree を使うと、新しい worktree のチェックアウトが逐次処理のため時間がかかっていた。リポジトリが大きいほど起動までの待ち時間が長くなっていた。

変更後

大規模リポジトリで --worktree を使うと、git 2.32 以降では新しい worktree のチェックアウトが並列で実行される。その結果、worktree の起動がこれまでより速く完了する。

ユーザーへの恩恵

開発者は大規模リポジトリでも worktree セッションの起動を短時間で待てるようになる。

変更前

macOS でも permissions.blockReadsOutsideWorkingDirectories が正しく機能し、サンドボックス化された git コマンドからユーザーの git config を保護し、worktree 分離されたサブエージェントも自身のチェックアウトに問題なくアクセスできる。

変更後

permissions.blockReadsOutsideWorkingDirectories が有効な環境でサンドボックス内の git コマンドがユーザーの git config を読めず、worktree 分離されたサブエージェントも自身のチェックアウトを参照できずに動作しなかった。

ユーザーへの恩恵

macOS ユーザーはファイル読み取り制限を有効にしても git 操作や worktree 分離されたサブエージェントが正常に動作するようになる。

変更前

worktree の git メタデータ欠落を検出すると、セッションは worktree を使わずに通常のディレクトリで再開し、以降の再試行も成功する。

変更後

セッションの worktree ディレクトリから git メタデータが失われた後も、-p --resume/--continue による再試行が毎回失敗していた。

ユーザーへの恩恵

デスクトップアプリで一時的な git メタデータの欠落が起きても、セッション再開が恒久的に失敗せず、1 回の失敗で済むようになる。

変更前

未pushのコミットが残るワークツリーを持つバックグラウンドセッションを削除しようとしても、Claude Code はワークツリーとセッションを保持するだけで、ユーザーはワークツリーのパスを手作業で調べて git worktree remove --force を実行した後、再度 claude rm を実行する必要がありました。

変更後

削除時に警告メッセージに未pushのコミットがあるブランチ名とコミット数が表示され、同じセッションをもう一度削除するとワークツリーごと破棄できるようになりました。

ユーザーへの恩恵

メッセージから対象ブランチとコミット数がすぐ分かり、再削除するだけで未pushコミットのワークツリーを破棄できるため、手作業でのワークツリークリーンアップが不要になります。

変更前

フックによって作成されたワークツリーを使用しようとした際、git rev-parse コマンドが「not a git repository」というメッセージ以外のエラーを返す環境では、Claude Code がそのワークツリーの使用を拒否していました。

変更後

フックによって作成されたワークツリーを使用しようとした際、git rev-parse コマンドが「not a git repository」というメッセージ以外のエラーを返す環境でも、Claude Code はそのワークツリーの使用を拒否しなくなりました。

ユーザーへの恩恵

フックによって作成されたワークツリーを、git rev-parse が特定のエラーメッセージ以外で失敗する環境でも正常に使用できるようになります。

変更前

作業ツリー分離セッションでは、メインチェックアウトに到達できない一般的な Bash ループや xargs パイプライン、ラッパー付きコマンドなどが実行されると、セッションがそれらを拒否してエラーとなっていました。

変更後

作業ツリー分離セッションは、メインチェックアウトに到達できない一般的な Bash ループ、xargs パイプライン、およびラッパー付きコマンドを正常に実行できるようになりました。

ユーザーへの恩恵

作業ツリー分離セッションであっても、一般的なシェル構文やパイプラインを含むコマンドを安全に実行できるようになります。

変更前

サンドボックス化された git コマンドを実行中に、リンクされた git worktree 内のサブディレクトリに移動すると、その後の操作でリポジトリの共通 .git ディレクトリへの書き込みが拒否されることがありました。

変更後

サンドボックス化された git コマンドを実行中に、リンクされた git worktree 内のサブディレクトリに移動しても、リポジトリの共通 .git ディレクトリへの書き込みアクセスが維持されるようになりました。

ユーザーへの恩恵

リンクされた git worktree 内でサンドボックス化された git コマンドを、サブディレクトリ間を移動しても正常に実行できるようになります。

変更前

元の会話のプロンプトキャッシュは新しいバックグラウンドセッションに継承されませんでした。ワークツリーのブリーフィングはシステムプロンプトの変更として扱われていました。

変更後

元の会話のプロンプトキャッシュが新しいバックグラウンドセッションに継承されます。ワークツリーのブリーフィングはシステムプロンプトの変更ではなく、メッセージとして届きます。

ユーザーへの恩恵

プロンプトキャッシュが維持されるため、セッション間のコンテキストを効率的に引き継げます。

変更前

バックグラウンドセッションとそのサブエージェントは、git worktree add で作成した git worktree 内のファイルを編集できませんでした。

変更後

バックグラウンドセッションとそのサブエージェントは、git worktree add で作成した git worktree 内のファイルを編集できるようになりました。

ユーザーへの恩恵

git worktree 内のファイル編集が可能になり、サブエージェントの作業が正しく実行されます。

変更前

gitlab.com の origin で --worktree --tmux にマージリクエスト番号を指定した際、Claude Code は GitLab の ref を直接取得するのではなく、失敗する GitHub スタイルのフェッチを先に行っていました。

変更後

gitlab.com の origin で --worktree --tmux にマージリクエスト番号を指定した際、Claude Code は GitLab の ref を直接取得するようになり、失敗する GitHub スタイルのフェッチを先に行うことはなくなりました。

ユーザーへの恩恵

GitLab のマージリクエストからワークツリーを作成する際の動作が正確になり、不要なフェッチエラーが発生しなくなります。

変更前

ワークツリーブランチが既にチェックアウトしたデフォルトブランチにマージされているがまだプッシュされていない場合、claude agents と claude rm がそのセッションを削除できず「どこにもプッシュされていないコミットがあります」と拒否していました。

変更後

マージ済みのブランチであっても、まだプッシュされていない場合でもセッションを削除できるようになります。

ユーザーへの恩恵

マージ済みのブランチでもセッションを適切に削除でき、ワークツリーの管理が容易になります。

変更前

バックグラウンド化されたワークツリーセッションがチェックアウトを失うことがありました。

変更後

バックグラウンドセッションは実行中にワークツリーのロックを保持するため、チェックアウトが失われることがなくなりました。

ユーザーへの恩恵

バックグラウンドセッション中の作業内容が保持され、データ損失が防止されます。

変更前

古いバックグラウンドセッションの記録が指していた .claude/worktrees/ 以下のユーザーが作成した Git worktree を、バックグラウンド保持スイープが削除していました

変更後

古いバックグラウンドセッションの記録が指していた .claude/worktrees/ 以下のユーザーが作成した Git worktree が、バックグラウンド保持スイープによって削除されなくなりました

ユーザーへの恩恵

ユーザーが意図的に作成した worktree が誤って削除されるのを防ぎ、ワークツリーの管理が正確になりました

変更前

同じリポジトリから /ultrareview 実行とクラウドセッションを同時に起動した際、別の起動の未コミット変更を含んで開始することがありました。

変更後

同時起動時でも、正しいリポジトリの状態でセッションが開始されるようになりました。

ユーザーへの恩恵

意図しない変更が適用されるリスクが排除され、コードレビューの正確性が保証されます。

変更前

既にローカルから削除してしまった古い作業用フォルダや Git ワークツリーに関連づけられているセッションを /resume 経由で復元しようとすると、その存在しないディレクトリへの移動（cd）を試みてエラーが発生し、再開に失敗していました。

変更後

元の保存先ディレクトリが削除されていることを検出した場合、パス移動を行わず、現在 CLI を開いているカレントディレクトリ上でセッション履歴をそのまま展開し、スムーズに会話を再開できます。

ユーザーへの恩恵

削除された古いブランチやフォルダの履歴であっても、エラーに邪魔されることなく今いる場所から直接引き継いで作業できます。

変更前

隔離されたワークツリー環境へ特定の除外ファイルをコピーするために .worktreeinclude に **/config/.env のような記述を行っても、その親ディレクトリが .gitignore に登録されていると、検索の段階で無視されてしまい、新しいワークツリーにファイルがコピーされませんでした。

変更後

.worktreeinclude に定義されたパターンマッチングは、親フォルダが gitignore 対象であっても強制的にスキャンを行い、指定されたファイルを正しく解決してワークツリーへと引き継ぎます。

ユーザーへの恩恵

gitignore ディレクトリ配下の設定ファイルをワークツリーへ引き継ぐために、手動でコピーする手間がなくなります。

変更前

Git の拡張設定（extensions.worktreeConfig）が有効な状態で Linux のサンドボックス機能（bubblewrap等）を利用すると、本来存在しないはずの個別ワークツリー用ファイルを保護しようとして不適切なマウント操作が行われ、サンドボックス内で git status などのコマンドが一切通らなくなっていました。

変更後

ファイルの存在チェックが適正化され、.git/config.worktree が存在しない場合は保護対象から外します。これにより、サンドボックスが作動している最中であっても、通常通りあらゆる git コマンドを実行させることができます。

ユーザーへの恩恵

ワークツリーを多用する開発リポジトリでも、サンドボックス保護をかけた状態で不自由なく git 操作をエージェントに任せられます。

変更前

コマンドにリダイレクトがない場合でも、誤って制限の警告が表示されることがありました。

変更後

リダイレクトの有無を正しく判定し、不要な警告を抑制します。

ユーザーへの恩恵

正当なコマンド実行を阻害されることがなくなります。

変更前

GitLab のマージリクエスト（MR）を使用して作業用ツリー（worktree）を作成したり、エージェントビューで GitLab MR の状態を直感的に確認したりすることができませんでした。

変更後

--worktree フラグに GitLab MR の URL を直接渡してブランチを作成できるようになり、claude agents ビューでもマージリクエストが「!N」形式で識別表示されるようになります。

ユーザーへの恩恵

GitHub だけでなく GitLab を使用している環境でも、マージリクエストの URL を指定するだけで簡単に関連作業用ツリーを構築し、エージェントの状態を確認できるようになります。

変更前

ワークツリーによる隔離セッションやサブエージェントが、意図せずメインの作業ツリーに対して破壊的なgit操作を行ってしまう可能性があり、並列実行時の安全性が不完全でした。

変更後

隔離設定が強化され、すべてのセッションタイプにおけるファイル編集やBashの実行に対して完全にワークツリーが適用され、メインリポジトリが保護されます。

ユーザーへの恩恵

並列セッションを実行する際に、メインのソースコードを破壊される心配をすることなく並行して安全に作業を進めることができます。

変更前

フォークされたセッションが元のセッションと同じチェックアウト先を使用していました。

変更後

フォーク時に独立した新しいワークツリーを自動生成するように変更しました。

ユーザーへの恩恵

並行して複数のタスクを進めても、セッション間でファイルの変更が競合しなくなります。

変更前

サブエージェントが作業する際に、メインのリポジトリ環境の Git 設定を誤って参照し、競合の原因となっていました。

変更後

サブエージェントの作業は隔離された worktree に厳密に制限され、メインディレクトリへの干渉がなくなりました。

ユーザーへの恩恵

並行して複数のブランチで作業しても、Git の操作対象を間違える不安がなくなります。

変更前

プロジェクトの場所と作業ディレクトリが乖離していると、不適切な場所にセッション用 worktree が生成されていました。

変更後

プロジェクトの構成を正確に判定し、正しい場所に worktree が作成されるようになりました。

ユーザーへの恩恵

セッション開始時に毎回、正しいディレクトリに作成されたか確認する必要がなくなります。

変更前

リポジトリ外への書き込みが発生する可能性があり、Git の整合性が保てないことがありました。

変更後

ワークツリーの作成ロジックが安全に制限され、リポジトリ内の指定ディレクトリのみを操作するように修正されました。

ユーザーへの恩恵

ワークツリー作成時にファイルシステムの汚染や意図しないディレクトリ操作を意識する必要がなくなります。

変更前

手動でディレクトリを消したりgit worktree pruneが行われたりして、gitから見たワークツリーの情報が壊れると、エージェントビュー(claude agents)からジョブを削除しようとしても無言で失敗し、行が残り続けていました。

変更後

gitが認識できない状態でもジョブの削除が成功するようになりました。削除できなかった場合も、単に再表示されるのではなく、なぜ削除が拒否されたかの理由(未プッシュのコミットがある等)が表示されます。

ユーザーへの恩恵

不要になったバックグラウンドタスクの行がリストに居座り続けることがなくなり、エージェントビューを常にクリーンに保てる。

変更前

「はい、今後表示しない」を選択した際の承認は、コマンドを実行したディレクトリに保存されていました。そのため、サブディレクトリや別のワークツリーで同じコマンドを使うと、再度許可を求められていました。

変更後

リポジトリのルートにある.claude/settings.local.jsonにルールが保存されるようになりました。一度許可すれば、リポジトリ内のどこで作業していても、また新しいワークツリーを作っても承認が引き継がれます。

ユーザーへの恩恵

同じリポジトリ内であれば、作業場所を変えても同じコマンドに対して何度も許可を求められる煩わしさがなくなる。

変更前

isolation: 'worktree' を設定したサブエージェントが、隔離された環境内ではなく、誤ってメインのチェックアウトディレクトリに対して git 操作を行ってしまうリスクがあった。

変更後

サブエージェントが実行する git コマンドが、必ず自身に割り当てられた隔離ワークツリー内で動作するように厳格化された。

ユーザーへの恩恵

並列作業中のサブエージェントがメイン作業中のファイルを誤って書き換えてしまう心配がなくなります。

変更前

エージェントプロセスが異常終了した際、使用していたワークツリーに git worktree lock が残ったままになることがあった。このロックにより、後続のクリーンアップ処理が失敗し、不要なディレクトリが残り続けていた。

変更後

定期的なクリーンアップ処理において、所有プロセスが存在しないロックを自動的に検知して解除するようになった。

ユーザーへの恩恵

エージェントがクラッシュした後に、手動で git コマンドを叩いてロックを解除する必要がなくなります。

変更前

エージェントを削除すると、プッシュしていないコミットが含まれるワークツリーが意図せず消えたり、再利用時に不整合が起きたりすることがあった。

変更後

未プッシュのコミットがある場合は削除を回避し、ワークツリー再利用時はベースブランチをリセットして安全性を確保する。

ユーザーへの恩恵

エージェントが作成したコード変更を誤って失うリスクがなくなり、安心して並列作業を行えるようになる。

変更前

並列作業用のワークツリーを削除した後もGitの設定ファイル（.git/config）に不要なエントリが残り続け、これが原因でteaなどのgo-gitベースのツールが正常に動作しなくなることがありました。

変更後

ワークツリーのクリーンアップ処理が改善され、関連するGit設定も適切に削除されるようになりました。

ユーザーへの恩恵

Claude Codeを使用した並列開発を行っても他の開発ツールと干渉しなくなり、既存の開発環境を壊す心配がなくなります。

変更前

設定ファイル内で[a-z]のようなパターンを記述する際に形式が不適切だと、ファイル検索やワークツリーへのファイルコピーが予期せず失敗したり、不完全な結果になったりすることがありました。

変更後

パターンの解析処理が堅牢になり、多少の記述の不備があっても致命的なエラーを避け、正しくファイルが読み込まれるようになりました。

ユーザーへの恩恵

ファイルの除外設定やスキル定義が意図通りに機能するようになり、リポジトリ構成の不整合によるエラーに悩まされることがなくなります。

変更前

Gitワークツリーを利用したバックグラウンドセッションを再開（resume）した際、読み込みの不備によって会話履歴が表示されず、作業を継続できない状態になることがありました。

変更後

ワークツリー上でのセッション管理が改善され、中断した場所から確実に会話を再開できるようになりました。

ユーザーへの恩恵

長時間かかる並列タスクを安心して中断・再開でき、作業の継続性が保証されます。

変更前

ワークツリーの場所に関わらず AI が自動的に移動できていたため、予期せぬディレクトリへの操作のリスクがありました。

変更後

標準的な隔離場所以外のワークツリーにアクセスする際はユーザーに確認を求めるステップが追加されました。

ユーザーへの恩恵

AI による不透明なディレクトリ移動を防ぎ、開発環境の安全性が高まります。

変更前

ワークツリー内にNTFSジャンクションやディレクトリシンボリックリンクが存在する場合、削除処理がワークツリーの外側のファイルを誤って削除してしまう不具合がありました。

変更後

削除処理のパス判定が改善され、ワークツリー内のみを対象とするようになりました。

ユーザーへの恩恵

Windows環境でのファイル管理が安全になり、大切なデータが誤って消去されるリスクが排除されました。

変更前

リポジトリの構造が複雑だと、シェル実行時に「Argument list too long」エラーで失敗することがありました。

変更後

引数の処理方法を最適化し、大規模なリポジトリでも動作するように修正しました。

ユーザーへの恩恵

巨大なモノレポなどでも問題なくコマンドを実行できます。

変更前

サブエージェントが適切な作業ディレクトリではなく、親リポジトリでシェルを実行してしまうことがありました。

変更後

サブエージェントの作業コンテキストを分離されたWorktreeに強制するように修正しました。

ユーザーへの恩恵

並列作業中に意図しないファイル変更やコマンド実行が起こるリスクが低減されます。

変更前

深い階層のリポジトリ構成でWorktreeの作成が拒否されることがありました。

変更後

階層構造を適切にハンドリングするように修正しました。

ユーザーへの恩恵

複雑なディレクトリ構成でも、問題なくエージェントの並列化が利用できます。

変更前

Worktreeを使用している際に、ディレクトリ候補としてリストに出てきませんでした。

変更後

Git Worktreeのリストを正しくピッカーに含めるようにしました。

ユーザーへの恩恵

複数のプロジェクトを効率的に管理している場合、迅速な作業切り替えが可能です。

変更前

リポジトリ構造が複雑な環境において、セッション検索時に全ファイルを走査するため、起動とメモリ利用が非効率でした。

変更後

セッション管理のインデックス処理を最適化し、大規模なワークツリー環境でも高速に起動できるようにしました。

ユーザーへの恩恵

複雑なリポジトリ環境であっても、Claude Codeの再開速度が大幅に改善されます。

変更前

エージェントが作業を終えるたびにユーザーに確認を求め、停止してしまうことがありました。

変更後

ワークツリーでの作業完了後、ユーザーの手を介さずに自動で一連のGit操作とPR作成を行うようになりました。

ユーザーへの恩恵

定型的なプルリクエスト作成プロセスが自動化され、作業のリードタイムが短縮されます。

変更前

ワークツリー環境下での移動時にディレクトリ解決がうまくいかず、デスクトップ連携機能が使えないことがありました。

変更後

ワークツリー内でも適切にディレクトリが識別され、デスクトップ連携が正しく機能するようになりました。

ユーザーへの恩恵

ワークツリーを使用した並列作業環境でも、デスクトップアプリとの連携がシームレスに行えます。

変更前

バックグラウンドエージェントが異常終了したりプロセスが殺されたりした際、.git/worktrees/ 内の登録情報がロックされたまま残留し、手動での削除が必要になることがありました。

変更後

不要になったワークツリーの登録が自動的に検知・解除されるようになり、Git 環境をクリーンに保てるようになりました。

ユーザーへの恩恵

ディスク容量の無駄遣いや Git 操作時の予期せぬ競合を回避し、手動でのメンテナンスの手間を省けます。

変更前

Windowsにおいて git コマンドが直接解決できない環境で、不要になったワークツリーを削除しようとすると「ワークツリーの状態を確認できません」というエラーが出て削除に失敗していました。

変更後

ワークツリーの削除ロジックが改善され、依存関係の解決が困難な状況でも安全にクリーンアップを実行できるようになりました。

ユーザーへの恩恵

不要なファイルやディレクトリが残ることを防ぎ、開発環境を常に整理された状態に保てます。

変更前

ディレクトリを移動した後も、ステータスラインや内部情報が移動前のブランチ名を表示したままになることがありました。

変更後

移動先のディレクトリに基づいた最新の Git 情報が即座に反映されるようになります。

ユーザーへの恩恵

現在の作業コンテキストを正確に把握でき、誤ったブランチに対して操作を依頼するリスクを回避できます。

変更前

AI が本来編集すべきでない場所を書き換えようとして拒否され、手番(トークン)を無駄にしてしまうことがありました。

変更後

AI は「まず EnterWorktree で作業場所を確保する必要がある」ことを事前に理解するため、無駄な試行を避けて正しい手順を即座に踏むようになります。

ユーザーへの恩恵

特にマルチタスク実行時における AI の動作効率が上がり、トークン消費の無駄を抑えられます。

変更前

ワークツリー上でのバックグラウンドタスクを中断・再開しようとすると、セッションデータを見失い作業が継続できなくなることがありました。

変更後

セッションの再開ロジックが改善され、ワークツリー環境下でも安定してタスクを再開できます。

ユーザーへの恩恵

大規模なプロジェクトで複数のワークツリーを使い分ける際の信頼性が向上します。

変更前

実際には作業用のブランチにいるにもかかわらず、リポジトリの構成によっては Claude がデフォルトブランチと誤認して PR の自動修正を拒否することがありました。

変更後

ワークツリーなどの複雑な Git 構成下でもブランチの状態を正しく認識し、自動修正ワークフローを開始できるようになりました。

ユーザーへの恩恵

CI 失敗の修正などを自動化する際、プロジェクトの構成を気にすることなく「/autofix-pr」の恩恵を受けられるようになります。

変更前

Git 以外のバージョン管理システムや特殊なディレクトリ構成を使用している場合、過去のセッションを再開しようとしても一覧に出てこないことがありました。

変更後

ディレクトリの管理状態に関わらず、現在の場所に関連付けられたセッションが正しくピッカーにリストアップされるようになりました。

ユーザーへの恩恵

どのような開発環境であっても、中断した作業を「--resume」から即座に再開できるようになります。

変更前

隔離された環境で作業させるためのワークツリー設定が、逆にエージェント自身の書き込み権限まで制限してしまい、エラーが発生していました。

変更後

ワークツリーによる隔離を維持しつつ、エージェントが割り当てられた範囲内で自由にファイルを編集・保存できるようになりました。

ユーザーへの恩恵

メインの作業ブランチを汚さずにエージェントに並列作業を任せる「隔離ワークツリー」機能が、安定して動作するようになります。

変更前

セッション開始時にワークツリーを作成した場合、そのセッション内では別の隔離環境へ移動することが困難でした。

変更後

作業のコンテキストに応じて、実行中のセッションを維持したまま別のワークツリーへ「飛び移る」ことが可能になります。

ユーザーへの恩恵

並行して進めている複数のタスク間を、Claude との対話を途切れさせることなく自在に行き来できます。

変更前

Claude が作成したワークツリーがロックされたまま残り、手動での git コマンドによる削除を妨げることがありました。

変更後

エージェントの作業完了とともに適切にロックが解除され、標準的な git メンテナンスコマンドで一括削除できるようになります。

ユーザーへの恩恵

不要になった一時的なディレクトリがディスクを圧迫するのを防ぎ、リポジトリを常にクリーンな状態に保てます。

変更前

古いジョブの履歴が削除された後も、関連するディスク上のワークツリーディレクトリだけが残ってしまうことがありました。

変更後

ジョブのクリーンアップに合わせて物理的なディレクトリも適切に削除されるようになります。

ユーザーへの恩恵

長期間の使用においても、見えないゴミデータがプロジェクトディレクトリ内に溜まることを防げます。

変更前

特定のワークツリーで作業を開始しても、コマンドの実行後に勝手にメインのルートディレクトリへカレントディレクトリが移動してしまうことがありました。

変更後

指定したワークツリー内での滞在が維持され、意図したディレクトリで継続して作業できます。

ユーザーへの恩恵

ディレクトリ移動の手間が省け、ワークツリーによるマルチタスク環境がより安定します。

変更前

既にワークツリーで作業している最中に「さらに別のワークツリー(サブエージェント用)」を作ると、現在の作業内容(コミット前の変更など)が含まれず、古いマスターの状態に戻ってしまうことがありました。

変更後

設定が"head"の場合、現在の作業コンテキストである現在のワークツリーのHEADを正しくベースとして新しいワークツリーが作られます。

ユーザーへの恩恵

複雑な機能を複数のブランチに分けて並行開発している際も、現在の修正内容を維持したままサブエージェントに作業を依頼できるようになります。

変更前

AIが生成したファイル(ビルド成果物など)が、保存したはずなのに見つからないという混乱が生じていました。

変更後

出力先が正しく管理され、意図した場所にファイルが確実に書き込まれるようになります。

ユーザーへの恩恵

AIが作成したファイルが見失われることがなくなり、作業結果の信頼性が向上します。

変更前

git worktree内で作業している際、Claudeが誤ってメインリポジトリ全体の書き込み権限を持ってしまい、サンドボックスの隔離が不十分でした。

変更後

書き込み許可範囲が、ワークツリーで共有が必要な.gitディレクトリの一部のみに厳密に絞り込まれ、hooksやconfigへの不正な書き込みもブロックされるようになりました。

ユーザーへの恩恵

複数のワークツリーを並行して使用する際の安全性が向上し、メインのプロジェクト設定を誤って変更される心配がなくなります。

変更前

git worktree を利用して作業場所を分離した後に会話を分岐(ブランチ)させようとすると、会話履歴が見つからないという誤判定が起きていました。

変更後

ワークツリーやバックグラウンドの状態に関わらず、正しく現在の会話コンテキストを引き継いでブランチを作成できるようになりました。

ユーザーへの恩恵

複数の試行錯誤を並行して行う際、エラーを気にせず自由に会話を分岐させて実験を続けられるようになります。

変更前

git 以外のバージョン管理システム(SVN や Perforce など)を使っている場合、バックグラウンド実行時の「作業コピーを壊さないための隔離」がうまく機能しない可能性がありました。

変更後

フックを通じてカスタムワークツリーを作成している環境でも、メインの作業場所とバックグラウンド作業の隔離が正しく強制されるようになりました。

ユーザーへの恩恵

どのような開発環境でも、バックグラウンドでの AI の作業が自分の手元の作業を誤って上書きしてしまうリスクが解消されます。

変更前

バックグラウンドセッションは常に独立したgit worktreeを必要としていましたが、巨大なモノレポなどworktree作成に時間がかかる環境では不便でした。

変更後

設定によりworktreeをスキップし、現在のディレクトリを直接編集できるようになります。

ユーザーへの恩恵

worktreeをサポートしていない、あるいは非効率な開発環境でも、バックグラウンドでの並列作業が可能になります。

変更前

gitコマンドでのクリーンアップに失敗すると強力な強制削除(rm -rf)が実行され、無視設定した重要なファイルまで消えるリスクがありました。

変更後

削除の安全性が強化され、不確実な状況ではファイルを消さずに残すようになりました。

ユーザーへの恩恵

誤操作やツールの不具合によって、手元の貴重なコードや設定ファイルが失われる心配がなくなります。

変更前

作業ディレクトリの衝突が発生した際、何が問題なのか、どのようにクリーンアップすればよいのかが分かりにくい簡素なエラーのみが表示されていました。

変更後

エラーの原因となった具体的なパスや解決策が示されるようになり、スムーズにワークツリー機能を再開できるようになりました。

ユーザーへの恩恵

Gitワークツリーを活用した並列作業時のトラブル解決が早まります。

変更前

新しい作業ツリー(worktree)を作成する際、ブランチの起点となるリファレンスがバージョンによって異なり、未プッシュのコミットが含まれない場合がありました。

変更後

worktree.baseRef 設定により、fresh(デフォルトのブランチ)または head(現在のローカルコミット)のどちらを起点にするか明示的に指定できます。

ユーザーへの恩恵

未プッシュの変更を作業ツリーに引き継ぎたい場合に head を指定することで、作業の中断や隔離をスムーズに行えるようになります。

変更前

サブエージェントに git ワークツリーによる分離環境を与えた際、過去のセッションで残っていた古い環境が完全にクリーンアップされず、状態が引き継がれてしまうことがありました。

変更後

各セッションで常にクリーンなワークツリーが作成・使用されるよう、分離の完全性が担保されます。

ユーザーへの恩恵

前の作業の影響を受けない独立した環境でサブエージェントが動作するため、コード生成やテストの再現性が向上し、予期せぬ副作用を防げます。

変更前

--worktree フラグで生成された環境で、PR リンクの表示や PR 情報に基づいたコンテキストの読み込みが機能しないことがありました。

変更後

作業ツリー環境下でも Git リモート情報が正しく追跡され、PR とセッションが正しく紐付けられます。

ユーザーへの恩恵

並行して複数のブランチを独立したディレクトリで作業するワークフローにおいても、Claude が PR の文脈を完全に理解して支援を継続できます。

変更前

セッション実行中に git worktree を作成して移動すると、その後のアップデート操作や UI モードの変更(/tui)が正常に動作しなくなる不当な挙動がありました。

変更後

worktree への移動後も、カレントディレクトリやセッション状態が正しく維持され、すべてのコマンドが継続して利用できるよう修正されました。

ユーザーへの恩恵

作業ディレクトリの切り替えを伴う柔軟な開発ワークフローの中でも、Claude Code のすべての機能を一貫して利用し続けることができます。

変更前

ワークツリー機能を利用する際、既に存在するワークツリーディレクトリへの直接的な切り替えや再利用が容易ではありませんでした。

変更後

EnterWorktreeツールでpathパラメータを指定できるようになり、既存のワークツリーへの移動がスムーズに行えるようになりました。

ユーザーへの恩恵

複数の作業ブランチをワークツリーで並行管理している場合に、既存の環境を即座に再利用できるため、作業の切り替えが高速化されます。

変更前

PRがスカッシュマージされた後、サブエージェントが使用していた一時的なワークツリーが削除されずに残り続け、ディスク容量を圧迫することがありました。

変更後

マージの形式を問わず、役割を終えたワークツリーがより正確に検出・削除されるようになりました。

ユーザーへの恩恵

開発マシンのストレージ容量が無駄な一時ファイルで枯渇するのを防ぎ、環境を常にクリーンに保てます。

変更前

セッションを閉じる際、次にどのようにコマンドを叩けば同じ会話を再開できるかの案内(Resume this session with...)が表示されない場合がありました。

変更後

セッションの終了方法に関わらず、再開用のコマンド案内が確実に出力されるようになりました。

ユーザーへの恩恵

複雑な作業の続きを再開する際のコマンドを覚えたりメモしたりする必要がなくなり、スムーズに作業に戻れます。

変更前

前回のセッションが正常に終了せず、一時的な作業ツリー(ワークツリー)のディレクトリが残っていると、同じ名前で作業を開始できないことがありました。

変更後

古い残存ディレクトリを適切に処理し、新しいセッションをスムーズに開始できるようになります。

ユーザーへの恩恵

クラッシュ後の再開や、同一名での繰り返し作業におけるワークフローの停止を防げます。

変更前

過去のセッションを視覚的に選んで再開するピッカーにおいて、特定の環境や操作で表示が欠けたり、誤ったディレクトリで再開されるなどの不便がありました。

変更後

多岐にわたるUI・ロジックの修正により、どのようなターミナルやプロジェクト構造でも直感的にセッションを再開できるようになりました。

ユーザーへの恩恵

プロジェクトをまたいだ並行作業や、作業の中断・再開がより確実かつ快適になります。

変更前

リモート操作中にエラーが発生すると、背後で作成された作業ディレクトリが消えずに残ったり、エラー内容がログに残らず原因究明が難しいことがありました。

変更後

Remote Controlの安定性とトレーサビリティが向上し、予期せぬ切断時の後処理も自動化されました。

ユーザーへの恩恵

外出先からスマートフォン等で作業を依頼する際、より安定してセッションを維持・復旧できるようになります。

変更前

カスタムステータスラインを作成する際、現在のセッションが通常のディレクトリなのか、git worktree による隔離環境なのかを判別する標準的な方法がありませんでした。

変更後

JSONデータから直接 worktree 名を取得できるため、ステータスラインに現在の作業ブランチや worktree 情報を表示しやすくなります。

ユーザーへの恩恵

複数の worktree を使って並行作業をしている開発者が、ターミナルの最下部を見るだけで「今どの作業空間にいるか」を一目で把握できるようになります。

変更前

複数のプロジェクトやブランチを切り替えて作業している際、今どの条件でセッションを絞り込んでいるのかが分かりにくい状態でした。

変更後

絞り込み条件(コンテキスト)が詳細に表示されるようになり、迷わず目的のセッションを選択できます。

ユーザーへの恩恵

膨大なセッション履歴の中から、特定のプロジェクトや作業単位の記録を瞬時に見つけ出せるようになります。

変更前

カスタムステータスラインを作成する際、現在の環境が通常のレポジトリなのか、Claudeが作業用に作成した独立したworktree内なのかをスクリプト側で判別する標準的な方法がありませんでした。

変更後

ステータスラインスクリプトに渡されるJSONデータから、worktree内での作業中かどうかを直接判定できるようになりました。

ユーザーへの恩恵

並行して複数のタスクを進めている際に、今どの作業ブランチ(worktree)にいるかをステータスラインに正確に表示できるようになり、誤操作を防げます。

変更前

サブエージェントが独立した場所で作業していても、その影響でメインセッションのディレクトリ情報が混乱し、後続のコマンドが意図しない場所で実行されるリスクがありました。

変更後

サブエージェントの作業環境が完全に隔離され、親セッションの環境に影響を及ぼさないようになりました。

ユーザーへの恩恵

複数のディレクトリをまたぐ複雑な並行作業を、メイン環境を汚すことなく安全に実行できます。

変更前

git worktreeを使用している環境で別のワークツリーのセッションを再開しようとすると、手動で cd するよう指示されるだけで、手間がかかっていました。

変更後

セッション再開時にワークツリーの切り替えをより直接的に扱えるようになり、作業場所を問わず過去のコンテキストにアクセスしやすくなりました。

ユーザーへの恩恵

複数の機能開発を並行して行っている際に、ワークツリー間をまたいだコンテキストの復元が迅速に行えます。

変更前

Git以外のVCS(SVN等)をフックでサポートしようとしても、起動時のGitチェックで処理が止まってしまい、フックによるカスタム処理が実行できませんでした。

変更後

--worktree起動時のチェック順序が見直され、Gitがない環境でもフックによる独自のワークツリー作成処理を正しく開始できるようになりました。

ユーザーへの恩恵

Git以外のプロジェクト管理ツールを使用している開発者も、Claude Codeの強力な並行作業機能を活用できるようになります。

変更前

WorktreeCreate フックをHTTP経由で実行した際、フックによって作成されたgitワークツリーのパスをClaude Code側に正確に伝える標準的な方法がありませんでした。

変更後

HTTPフックのレスポンスJSON内の hookSpecificOutput.worktreePath フィールドを通じて、作成されたパスを返せるようになりました。

ユーザーへの恩恵

独自のサーバーで管理している複雑なワークツリー作成フローをClaude Codeとシームレスに統合でき、並行作業の自動化がより強固になります。

変更前

「feature/login-fix」のようなスラッシュを含む名前でワークツリーを作成しようとすると、ディレクトリ作成や Git の制限に引っかかり、何の説明もなく処理が中断されていました。

変更後

名前に含まれるスラッシュが適切に処理(置換またはエラー通知)され、プロセスが途中で止まることがなくなりました。

ユーザーへの恩恵

標準的なブランチ命名規則をそのままワークツリー名に使用してもトラブルが発生せず、並行作業がスムーズに行えます。

変更前

Git ワークツリーを利用した並行作業中に、そのワークツリー独自の自動化スクリプトやカスタムスキルが認識されませんでした。

変更後

ワークツリー環境からでも正しく設定ファイルが読み込まれ、メイン環境と同じ自動化機能が利用可能になりました。

ユーザーへの恩恵

複数の機能を並行して開発する際も、一貫した開発体験と自動化ツールを維持できます。

変更前

--worktreeフラグを使用するとリポジトリ全体がチェックアウトされるため、超大規模なリポジトリではディスク容量の消費や初期化に時間がかかっていました。

変更後

この設定により、特定のパスのみを対象とする「疎なチェックアウト(sparse-checkout)」が可能になり、必要なファイルだけを作業ツリーに含めることができます。

ユーザーへの恩恵

モノレポでの開発効率が大幅に向上し、不必要なファイルの取得を避けることでセットアップ時間の短縮とディスク容量の節約が実現します。

変更前

ワークツリーの作成時に毎回リモートとの通信(git fetch)が発生していたため、ネットワーク環境によっては起動に時間がかかることがありました。

変更後

ローカルの情報を優先的に参照するように最適化され、リモートブランチが既に手元にある場合は即座にセッションを開始できます。

ユーザーへの恩恵

並列作業を始めたい時に待たされる時間が短縮され、より軽快に作業環境を切り替えられます。

変更前

並行作業のためにGitワークツリー(--worktree)を使用している際、ステータスバーからは現在の作業場所の詳細が分かりませんでした。

変更後

ステータスラインをカスタマイズして、どのワークツリーで作業中かを常に表示できるようになりました。

ユーザーへの恩恵

複数のワークツリーを使い分けている時に、誤った場所で変更を行ってしまうミスを防ぎ、コンテキストの把握を助けます。

変更前

リモートコントロール機能は単一のセッションに限定されており、複数の異なるタスクを同時にリモートから並行して進めるための仕組みが不足していました。

変更後

サーバーモードが追加されたことで、複数のセッションを同時に立ち上げ、それぞれを Git ワークツリーなどで分離して実行・管理できるようになりました。

ユーザーへの恩恵

複数のプロジェクトやブランチにまたがる作業を、リモートデバイスから並行して効率的に進めることができるようになります。

変更前

Git ワークツリーを使用して並行セッションを実行している際、ステータスバーなどのカスタム表示において、現在のワークツリーに関する詳細情報を表示する直接的な手段がありませんでした。

変更後

ステータスライン構築用の JSON データにワークツリーの詳細が含まれるようになり、現在の作業環境がどのブランチ・どのディレクトリなのかを常に画面下に表示できるようになりました。

ユーザーへの恩恵

複数のワークツリーを使い分けて並行開発を行う際に、自分が今どこで作業しているのかを混同するリスクを大幅に減らせます。

変更前

--worktree オプションを指定しても、初回起動時に正しく認識されず、意図した通りにworktreeが作成されない場合がありました。

変更後

--worktree オプションが初回起動時から確実に機能するようになり、期待通りのworktreeが作成されるようになりました。

ユーザーへの恩恵

開発者は初回起動時から意図したworktree環境を確実に利用でき、作業の準備時間を短縮し、ワークフローをスムーズに進めることができます。

変更前

ワークツリーの作成・削除時にカスタムVCSのセットアップ/ティアダウンを行う機能がありませんでした。VCSの初期化やクリーンアップを自動化したい場合に、手動での対応が必要でした。

変更後

ワークツリーの作成・削除時にカスタムVCSのセットアップ/ティアダウンを行えるようになりました。これにより、VCSの初期化やクリーンアップといった定型作業を自動化できます。

ユーザーへの恩恵

VCSのセットアップとティアダウンを自動化することで、開発者はワークツリーのライフサイクル管理にかかる手間を省き、より効率的に開発を進めることができます。

変更前

エージェントが実行される環境を宣言的に指定する手段がなく、各エージェントの実行環境を個別に管理する必要がありました。

変更後

エージェント定義内で isolation: worktree を指定することで、エージェントを独立したGitワークツリーで実行できるようになりました。これにより、プロジェクトの分離が容易になります。

ユーザーへの恩恵

エージェントごとに独立した実行環境を用意できるため、依存関係の競合を防ぎ、よりクリーンで予測可能な開発フローを実現できます。

変更前

これまでは、Claude Codeで複数のタスクを並行して作業する場合、Gitリポジトリの異なる状態を扱うために手動でGit操作を行う必要がありました。これにより、作業間の切り替えが複雑になり、意図しない変更が他の作業に影響を与えるリスクがありました。

変更後

--worktree (-w) フラグを使用することで、Claude Codeのセッションを独立したGitワークツリーで開始できるようになりました。これにより、各セッションが自身の分離されたプロジェクトコピーを持つため、あるセッションでの変更がコミットされるまで他のセッションに影響を与えることがなくなります。

ユーザーへの恩恵

開発者は、メインブランチを汚すことなく、複数の機能開発やバグ修正を並行して安全に進めることができます。作業間のコンテキスト切り替えが容易になり、実験的な変更も気軽に試せるため、開発の効率と安全性が向上します。

変更前

以前は、サブエージェントがコードベースに変更を加える際、メインの作業ディレクトリに直接変更が適用される可能性がありました。これにより、サブエージェントが意図しない変更を加えたり、実験的な作業が他の開発者の作業と衝突したりするリスクがありました。

変更後

サブエージェントの設定でisolation: "worktree"を指定することで、サブエージェントが独立したGitワークツリー内で作業を行うことができるようになりました。これにより、サブエージェントが行うすべての変更はそのワークツリー内に隔離され、メインのコードベースや他のサブエージェントの作業に影響を与えません。

ユーザーへの恩恵

サブエージェントを使用した大規模な変更や実験的なタスクを、より安全かつ独立して実行できるようになります。メインプロジェクトへの意図しない変更のリスクが低減され、サブエージェントは自信を持ってコードを変更・テストできるため、開発者は安心してAIにタスクを任せられるようになります。

変更前

Windows環境において、ワークツリーセッションのマッチングが、ドライブレターの大文字・小文字の違いによって正しく行われない場合がありました。

変更後

Windows環境でのワークツリーセッションマッチングが修正され、ドライブレターの大文字・小文字の違いを吸収するようになりました。

ユーザーへの恩恵

Windows環境でのワークツリーセッションの利用が改善され、ドライブレターの大文字・小文字の違いを気にすることなく、セッションを正しくマッチングできるようになりました。

変更前

gitワークツリーからClaude Codeを実行する際、プロジェクトレベルの.claude/agents/および.claude/skills/ディレクトリにあるカスタムエージェントやスキルが検出されない問題がありました。

変更後

gitワークツリーから実行した場合でも、プロジェクトレベルの.claude/agents/および.claude/skills/が正しく検出されるようになりました。

ユーザーへの恩恵

gitワークツリー環境でのカスタムエージェントとスキルの利用が改善され、開発者はワークツリー内でもプロジェクト固有の設定を正しく利用できるようになりました。

変更前

gitワークツリー内でバックグラウンドタスクを実行する際、リモートURLの解決がワークツリー固有のgitdirから行われるため、メインリポジトリの設定が正しく読み取られず、タスクが失敗する問題がありました。

変更後

gitワークツリーでのバックグラウンドタスク実行時のリモートURL解決が修正されました。ワークツリー固有のgitdirではなく、メインリポジトリの設定から読み取るようになり、タスクが失敗しなくなりました。

ユーザーへの恩恵

gitワークツリー環境でのバックグラウンドタスクの実行が安定し、リモートURL解決の正確性が向上しました。これにより、開発者はワークツリー内でもバックグラウンドタスクを確実に実行できます。

変更前

git worktree を使用して複数のディレクトリで作業している場合、過去のセッションを再開して名前を変更しようとしても、意図しない別のセッションが更新されることがありました。

変更後

ディレクトリの場所に関わらず、現在アクティブなセッションを正確に特定して名前やタグの変更が適用されるようになりました。

ユーザーへの恩恵

複数の作業ブランチや worktree を行き来しながら開発する際、セッション管理がより正確になり、プロジェクトの整理が容易になります。