ターミナルとセットアップ

プロジェクトのターミナル、エージェントの長時間コマンド、ターミナル入力の許可、内蔵ツール。

Terminal タブでは、プロジェクトフォルダでシェルを実行します。エージェントのコマンドも同じターミナルの仕組みを使うため、エージェントが始めたコマンドは実行を続けられ、あなたとエージェントの両方がそれを見たり止めたりできます。

ターミナルを開く

タブバーの + メニュー、またはエディタの空の状態から Terminal を開きます。最初のセッションはプロジェクトフォルダで始まります。

Terminalタブ下部のバーには次のものがあります。

コントロール 動作
セッションタブ ターミナルのセッションごとに1つ。クリックで切り替え、x で閉じます(セッションが複数あるときに表示)。
New 別のセッションを開始します。ショートカット:ターミナルにフォーカスがあるときに Ctrl+Shift+`。
Clear アクティブなセッションの表示中の出力を消去します。

ターミナル内で右クリックすると、Copy、Paste、Select All、Clear Terminal、Add to Chat が使えます。Cmd/Ctrl+C、Cmd/Ctrl+V、Cmd/Ctrl+A でもコピー、貼り付け、全選択ができます。

長時間出力が続くものと手早いコマンドは、別々のセッションで実行しましょう。たとえば、1つのセッションでビルドを監視し、別のセッションで git status を実行します。

セッションはプロジェクトに属します。別のタブに切り替えても、パネルを隠しても、ウィンドウを再読み込みしても実行を続け、タブを閉じる、プロジェクトを削除する、Embedrを終了すると停止します。

ターミナルで使えるツール

Embedrのターミナルでは、内蔵のコマンドラインツールがパスの先頭に置かれるため、何もインストールせずに次のコマンドが使えます。

コマンド 用途
embedr ファームウェアプロジェクト:ビルド、書き込み、モニター、ライブラリ、ターゲット。CLIリファレンスを参照してください。
pcb SchematicsビューとBoardビューを支えるハードウェアのツールチェーン(Zenerのビルド、レイアウト、フォーマット)。回路図とPCBを参照してください。

簡単な確認:

embedr --version
embedr boards --limit 10
embedr devices
embedr compile

ターミナルではこれらが動くのにツールバーのボタンが失敗する場合は、ツールバーのターゲット、デバイス、環境を確認してください。ターミナルでも失敗する場合は、プロジェクトの設定かツールチェーンに問題があります。そのエラーの文面をエージェントに送ってください。

エージェントが実行するコマンド

エージェントがコマンドを実行すると、チャットに行が表示され、コマンドの出力がそこに流れます。短いコマンドはその行の中で完了します。

開発サーバー、ログの監視、長いビルドスクリプトなど、長時間実行されるコマンドはバックグラウンドで実行できます。そのチャットの行には Background のラベルが付き、2つのボタンがあります。

  • Open terminal は、セッションをTerminalパネルのタブとして開きます。様子を見たり、入力したりできます。
  • Stop で終了します。

バックグラウンドのコマンドは、エージェントが他の作業に移っても、実行が終わっても動き続けます。エージェントは後から戻って出力を読んだり、プロンプトを待ったり、停止したりできます。エージェントが始めたコマンドが、結果を読む前に終了した場合は、次のステップでエージェントに通知されます。

エージェントが始めたセッションのタブを閉じても、非表示になるだけです。エージェントは引き続き読んだり停止したりできます。自分で開いたターミナルを閉じると、そのシェルは終了します。

ツールバーやエージェントのビルドツールから始めたビルドや書き込みは、ターミナルのセッションではありません。出力は Output タブに表示され、エージェントはそれを停止できません。停止できるのはあなただけです。

エージェントがターミナルに入力するとき

エージェントは、自分が始めたコマンドのプロンプト(たとえばインストーラーの Continue? [y/N])に答えたり、あなたが開いているターミナルでコマンドを実行したりできます。ターミナルに入力しようとするたびに、自動承認をオンにしていても、Embedrは必ず先にあなたに確認します。承認カードには次の内容が表示されます。

  • 入力する内容そのもの(Enterは ⏎ で表示され、Ctrl+Cなどの制御キーは文字で示されます)
  • どのターミナルか(あなたのものか、エージェントが始めたものか)、そのシェルとフォルダ
  • Enterを押す回数

エージェントは、承認を得て、あなたが開いたターミナルにCtrl+Cを送れますが、あなたのターミナルを閉じることはできません。

エージェントがターミナルに入力すると、その上にバナーが表示されます:The agent has typed in this terminal. You can keep typing too. Block agent input をクリックすると、そのターミナルでのエージェントの入力を止められます。その後バナーは Agent input is blocked in this terminal. になり、Allow agent input で元に戻せます。どちらの設定でも、あなたはいつでも入力できます。

エージェントが確認なしで実行できるコマンドは、Settings → Command Approval で設定します。設定とプライバシーを参照してください。

ターミナルの出力をチャットに追加する

ターミナルのテキストを選択して Add to Chat をクリックするか、右クリックして Add to Chat を選びます。エージェントには正確なテキストが渡るので、「何かPythonのエラーが出た」といった説明よりもうまく伝わります。

Windows

Windowsでは、エージェントのコマンドは既定で cmd.exe で実行され、代わりにPowerShellを選ぶこともできます。スペースを含むパスなど、引用符で囲んだパスを含むコマンドはそのまま渡されます。

"C:\Users\Ana\My Projects\robot\.pio\build\esp32dev\firmware.bin"

コマンドを停止すると、そのコマンドが始めたものもすべて停止します。

ブラウザ版

ブラウザ版Embedrでは、Terminalタブはプロジェクトのスナップショット上でクラウドのターミナルを開きます。

  • 上部に Cloud snapshot · close to save terminal file changes; reopen to load editor changes. という注記が表示されます。ターミナルで変更したファイルは、Close & save をクリックする(またはセッションのタブを閉じる)とプロジェクトに反映されます。その後エディタで行った編集は、次にターミナルを開いたときに反映されます。
  • node_modules や .pio などの生成されたキャッシュは、プロジェクトに保存されません。
  • セッションは30分で期限切れになります。
  • 接続が切れた場合は Reconnect を使います。入力が一時停止した場合は、Resume input で再開します。
  • 保存に失敗した場合は、Download recovery files でターミナルの変更を取得できます。

読み取り専用の共有プロジェクトでは、Terminalタブは先にプロジェクトをフォークするよう求めます。

ローカルツール(デスクトップ)

Settings → Local tools には、KiCad 10がインストールされているか(KiCad CLI、Check ボタン付き)が表示され、Where tools run で KiCad と SPICE simulation の実行場所を選べます。

選択肢 動作
Local when available このコンピューターにKiCad 10やngspiceがインストールされていればそれを使い、なければクラウドを使います。
Always cloud 常にクラウドで実行します。

ファームウェアのビルドは、常にEmbedr内蔵のツールチェーンを使ってあなたのコンピューター上で実行されます。PlatformIOを別途インストールする必要はありません。シミュレーションとボードとKiCadを参照してください。

よくある問題

症状 試すこと
embedr や pcb が見つからない Embedrのターミナルではなく、システムのターミナルを使っています。これらをパスに追加するTerminalタブを使ってください。
ターミナルに No Terminal Sessions と表示される Create Terminal をクリックします。
Terminal Error Retry をクリックします。失敗が続く場合は、Embedrを再起動します。
コマンドがいつまでも待っている 入力を待っている可能性があります。そのターミナルを開いて答えるか、承認したうえでエージェントに答えさせます。
エージェントがシェルへの入力を何度も求めてくる そのターミナルで Block agent input をクリックします。

その他の対処はトラブルシューティングにあります。