JetBrains IDE の Junie が WSL 環境で「Working」のまま止まる問題の対処方法

こんにちは、 wand です！

最近 AI Agent を活用し始めました。

私は Windows 11 / WSL 環境で JetBrains IDE (WebStorm / PhpStorm) を使っているため、 IDE 組み込みの Junie を使っています。

Junie をまともに活用するには有料のプランに加入する必要がありますが、2025/5/15 現在、 All Products Pack に加入していれば AI Pro プランが追加料金なしでついてきます。

まず手始めに .junie/guidelines.md を作らせてみたところ早速つまづいたので、今回はその詳細と回避方法についてご紹介します。

❌️ うまくいかないプロンプト例

下記のプロンプトを試しました:

コードベースを読み込んで.junie/guidelines.mdを作ってください。

すると以下の実行計画を得ました:

1. Explore the repository structure to understand the codebase
2. Check if the .junie directory already exists
3. Create the .junie directory if it doesn't exist
4. Create guidelines.md file with content based on the codebase
5. Verify the file has been created correctly

初手で ls コマンドを実行し始めて、「Working」のまま動かなくなってしまいました。

どうやら 2025/5/15 現在、 Junie は WSL2 上でサポートされていないみたいです😢

https://youtrack.jetbrains.com/issue/JUNIE-60

Junie on WSL2 はターミナルコマンドが動作しない！ (2025/5/15 現在)

✅️ うまくいったプロンプト例

WSL 、つまり Linux や Windows のコマンドに依存しなければよいのでは？

ということで、下記のプロンプトを試してみました:

コードベースを読み込んで.junie/guidelines.mdを作ってください。
Terminal の ls や dir コマンドは使用しないでください。

すると今度は以下のような実行計画を得ました:

1. Understand the repository structure to get a better idea of what should go into the guidelines
2. Examine key files like README.md to understand the project's purpose
...
7. Create the `.junie` directory if it doesn't exist
8. Create the `guidelines.md` file with appropriate content based on the codebase

ls などの Linux コマンドではなく、 IDE の機能でファイルを読み取るように実行計画が変わりました。
そして実際に .junie/guidelines.md が生成されました🎉

しばらく使ってみて気づいたこと

しばらくこの方法を試していて、いくつか気づいたことがあります。

まず、実装系のタスクではうまくいきやすいです。

「ユースケース記述 XXX.md を実装してください。  ls や dir などの Terminal コマンドを使わずに。」

一方で、ドキュメント系のタスクでは注意が必要です。

「環境構築手順を最新化してください。 ls や dir などの Terminal コマンドを使わずに。」

この場合、ドキュメント中のコードブロックにあるコマンド例まで、すべて文章に直し始めるという暴挙に出てしまいました。
「コマンドを使わずに」って、そういう意味じゃない😂

とはいえ、大半のケースではうまく動作するので、以下のようなガイドラインを .junie/guidelines.md に記入して、現在も運用を続けています。

DO NOT use `ls`, `dir`, or any other terminal commands during development, as this may cause you (Junie) to get stuck in
a `Working` state.
Instead, use the IDE’s built-in functionality to navigate the project.

コマンドを使わないように .junie/guidelines.md でガイドラインを定めましょう！

とはいえ、コマンドを実行できないとなると AI Agent の力は半減です。早期の WSL サポートを願うばかりですね。

まとめ

JetBrains の AI Agent「Junie」は、現時点（2025/5/15）では WSL 環境では正しく動作しないケースがあります。
特に Terminal 経由でファイル操作を試みると「Working」で停止する問題が発生します。

今回はプロンプトを工夫することで .junie/guidelines.md の生成に成功しました。
特に実装系のタスクではうまく動作します。公式の修正が入るまではこの方法でしのごうと思います。

AI Agent は、どんどん忙しくなっていく現代社会において、

• 「重要で緊急なこと」... 締め切りの近い仕事など
• 「(自分にとって) 重要ではないが緊急なこと」 ... 上司からの頼まれ事など
• 「重要でも緊急でもないこと」 ... 過度な娯楽など

に割く時間を減らし、本当に大切にしたい「緊急ではないが重要なこと」の時間を生み出す強力な手助けとなります。
今後の進化・発展に期待しつつ、上手に付き合っていきたいと思います！