ターミナルの使い方

この章では、端末自体について解説します。入出力、端末内検索、コピー/ペースト、画像の扱い、vopenコマンド、Windows上でのシェル選択、およびセッション録画についてです。

1. 基本事項

端末セッションとは実際のシェルのことで、macOS / Linuxではシステムデフォルトのシェルが、Windowsではデフォルトでcmdが使用され、必要に応じて切り替え可能です（§5を参照）。作業ディレクトリはプロジェクトのルートディレクトリになっており、セッションの編集画面から変更できます。ここには「起動コマンド」も用意されており、セッションが起動するたびに自動的に実行されます（例：pnpm dev）。

入力の遅延は特別に設計されており、多数のアジェントが画面を埋め尽くした場合でも入力が優先され、バックグラウンドのタブの処理が制限されるため、フロントグラウンドはキー入力に常に追いつきます。タブを切り替えた後にTUIが不具合を起こした場合は、パネルヘッダーにある再描画ボタンを押すことで完全に再描画されます。

2. 端末内検索（⌘F）

現在の端末のスクロールバック内容を検索し、次/前へのナビゲーションが可能です：

複数のセッションや履歴全体を検索するには、グローバル検索（⌘⇧F）を使用します。インターフェースとセッション管理の§8を参照してください。

3. コピーとペースト

• 対象を選択してハイライトし、コンテキストメニューからコピー/ペーストが行え、通常の⌘C / ⌘Vも利用可能です。
• マウス操作をサポートするTUIプログラム（vim、htopなど）内では、通常のテキスト選択を強制するため、ドラッグする際にOption/Altキーを押したままにします。

画像のペーストは、アジェントに画像を送信するための機能です。スクリーンショットや画像ファイルを端末にペーストまたはドラッグすると、VelaTermがその画像を一時ファイルに保存し、そのファイルパスを端末に表示します。これはclaudeのようなCLIが期待する動作そのものです。関連する設定として、「画像のペースト」では「ファイルとしてアップロード」（常にパスとして保存）と「アジェントのデフォルト」のいずれかを選択でき、「ペーストされた画像の自動削除」では定期的に一時画像を削除し、「今すぐ削除」ボタンも用意されています。

4. vopen：端末からファイルやページを開く

各セッションのPATHには、インストール不要の3つの簡単なコマンド（vopen、vspawn、vspawn-tree）が含まれています。これらは端末コマンドであり、claudeの会話内で使用される同名の/スキルとは別物で、設定 ▸ 一般でVela Skillsの切り替えが必要です。vopenは内容を中央のパネルに送信します：

vopen README.md          # markdown → WYSIWYG editor
vopen src/main.rs        # source code → syntax-highlighted editor
vopen diagram.png        # image → built-in image viewer
vopen https://crates.io  # URL → built-in browser tab (desktop only)

完全なドキュメントタブ（デュアルモード編集、検索・置換、PDFエクスポート）：ドキュメントとブラウザタブ。vspawnによる生成：セッションの生成とGitによるコラボレーション。

5. シェルの選択（Windowsのみ）

Windows上では、端末セッションでNewサブメニュー、セッション編集画面のドロップダウン、または右クリック「Shell ▸」を通じて、PowerShell / pwsh / cmd / Git Bashなどのシェルを明示的に選択できます。実行中のセッションは再起動時にその変更が適用されます。設定 ▸ 端末 ▸ 「デフォルトシェル」で新規セッションのデフォルト値を設定できます。

同梱されているGit Bashについて：フルインストーラーには完全なバージョン（git、ssh、perlも含まれる）が含まれ、ミニインストーラーにはコア部分のみが含まれます。不足しているコマンドがある場合は、必要に応じてフルバージョンがダウンロードされます（右クリック「フルGit Bashをダウンロード」からも利用可能）。アジェントセッションには影響しません。アジェントセッションでは常にPowerShellが使用されます。

macOS / Linuxにはシェル選択機能はなく、セッションではシステムデフォルトのシェル（$SHELL）が使用されます。

6. セッション録画

設定 ▸ 詳細設定 ▸ 「セッションログの録画」（デフォルトはオフ）。有効にすると、セッションが開始された瞬間から端末の内容がローカルファイルに記録されます（1セッションあたり50MBまで）。これにより以下の2つの利点が得られます：

• アーカイブされたセッションでは、端末の表示内容をそのまま再現できます。
• グローバル検索を使えば、通常の端末出力も検索可能です（アジェント間の会話はテキスト転記があるため録画不要です）。

セッションが削除されると、録画ファイルも自動的に削除されます。

7. 一般的なショートカット

macOSでは以下の値がデフォルトです。Windows / Linuxでは、⌘の代わりにCtrl+Altが使用されます（いくつかの例外があり、設定ページを確認してください）。⌘1–9とフォントサイズ関連のものを除き、すべてのショートカットは設定 ▸ ショートカットで再割り当て可能です。