Waveterm

永続セッション、インライングラフィックス、リモート接続管理を備えたAI統合オープンソースターミナル。

インストール

プラットフォーム別インストール

コマンド	説明
`brew install --cask wave`	macOSにHomebrewでインストール
`waveterm.dev`からダウンロード	公式Webサイトからインストール
リリースから`.deb`または`.rpm`をダウンロード	Linuxにインストール
リリースから`.exe`インストーラーをダウンロード	Windowsにインストール
`wsh version`	Wave CLIバージョンを表示
`wsh help`	利用可能なwshコマンドを表示

基本的な使い方

タブとウィンドウの管理

コマンド	説明
`Cmd/Ctrl + N`	新しいターミナルタブを開く
`Cmd/Ctrl + T`	新しいワークスペースタブを開く
`Cmd/Ctrl + W`	現在のタブを閉じる
`Cmd/Ctrl + Shift + N`	新しいウィンドウを開く
`Cmd/Ctrl + 1-9`	番号でタブを切り替え
`Cmd/Ctrl + Shift + ]`	次のタブ
`Cmd/Ctrl + Shift + [`	前のタブ
`Cmd/Ctrl + Shift + T`	最後に閉じたタブを再度開く

ブロックとペインの管理

コマンド	説明
`Cmd/Ctrl + Shift + D`	ターミナルを水平に分割
`Cmd/Ctrl + D`	ターミナルを垂直に分割
ブロックの境界をクリックしてドラッグ	ターミナルペインのサイズを変更
`Alt + 矢印キー`	ブロック間をナビゲート
`Cmd/Ctrl + Enter`	現在のブロックを最大化/復元
`Cmd/Ctrl + Shift + P`	コマンドパレットを開く
`Cmd/Ctrl + Backspace`	現在のブロックを閉じる

AI機能

AIチャット

コマンド	説明
`Cmd/Ctrl + Space`	現在のブロックでAIチャットを開く
AIチャットに質問を入力	コマンドやコードについてAIに質問
AIチャットで`/explain`	前のコマンド出力を説明
AIチャットで`/fix`	最後のエラーの修正を提案
AIチャットで`/summarize`	長い出力を要約
AIの提案で「Apply」をクリック	提案されたコマンドをターミナルに挿入
`Esc`	AIチャットパネルを閉じる

AIプロバイダー設定

コマンド	説明
設定でAIモデルを設定	OpenAI、Anthropic、ローカルモデルから選択
設定で`ai:preset`を設定	AIプロバイダーを切り替え
設定で`ai:apitoken`を設定	AIプロバイダーのAPIキーを設定
設定で`ai:model`を設定	モデル名を指定（例: gpt-4、claude-3）
設定で`ai:baseurl`を設定	カスタム/ローカルAPIエンドポイントを指定
設定で`ai:maxtokens`を設定	最大レスポンストークン数を設定

AI設定の例

{
  "ai:preset": "custom",
  "ai:apitoken": "sk-...",
  "ai:baseurl": "https://api.openai.com/v1",
  "ai:model": "gpt-4",
  "ai:maxtokens": 2048
}

Ollamaを使用したローカルモデルの場合:

{
  "ai:preset": "custom",
  "ai:baseurl": "http://localhost:11434/v1",
  "ai:model": "llama3",
  "ai:maxtokens": 4096
}

SSH接続

SSH操作

コマンド	説明
`wsh ssh user@hostname`	SSH経由でリモートホストに接続
`wsh ssh user@host -i ~/.ssh/key`	特定のIDキーでSSH接続
`wsh ssh -p 2222 user@host`	カスタムポートでSSH接続
「+」→「SSH Connection」をクリック	UIからSSH接続を作成
接続はセッション間で永続	アプリの再起動後もセッションが存続
`wsh ssh-import`	SSH設定の接続をインポート
`~/.ssh/config`エントリを設定	SSHホストを自動検出
接続を右クリック → 再接続	切断されたSSHセッションを再接続

SSH Config統合

Waveはホスト検出のためにSSH設定を読み取ります。シームレスな接続のためにエントリを設定してください:

Host prod-web
    HostName 10.0.1.50
    User deploy
    IdentityFile ~/.ssh/deploy_key
    Port 22

Host staging-*
    HostName %h.staging.example.com
    User admin
    IdentityFile ~/.ssh/staging_key
    ForwardAgent yes

Host jump-box
    HostName bastion.example.com
    User ops
    IdentityFile ~/.ssh/ops_key

Host internal-*
    ProxyJump jump-box
    User admin
    IdentityFile ~/.ssh/internal_key

リモートファイルブラウジング

コマンド	説明
`wsh view remote:file.txt`	リモートホストのファイルを表示
`wsh edit remote:file.txt`	リモートホストのファイルをインラインで編集
`wsh view remote:/var/log/syslog`	リモートのログファイルを表示
`wsh run --remote user@host -- command`	リモートホストで新しいブロックでコマンドを実行

ウィジェットとブロック

ファイルとコンテンツの表示

コマンド	説明
`wsh view file.png`	ターミナル内で画像をインライン表示
`wsh view file.jpg`	JPEG画像をインライン表示
`wsh view file.svg`	SVGグラフィックをインライン表示
`wsh view file.md`	Markdownをインラインレンダリング
`wsh view file.csv`	CSVをテーブルとして表示
`wsh view file.json`	シンタックスハイライト付きでJSONを表示
`wsh view file.pdf`	PDFドキュメントをプレビュー
`wsh view https://example.com`	ブロックにWebページを埋め込む

ブロック操作

コマンド	説明
`wsh edit file.txt`	インラインエディタでファイルを開く
`wsh edit --lang=python script.py`	言語モード付きでエディタを開く
`wsh getmeta`	現在のブロックメタデータを取得
`wsh setmeta key=value`	ブロックメタデータを設定
`wsh run -- command args`	新しいブロックでコマンドを実行
`wsh run --magnify -- htop`	最大化されたブロックでコマンドを実行
`wsh createblock`	空のブロックを作成
`wsh createblock --tabid=tab1`	特定のタブにブロックを作成

ウィジェットの使用パターン

コマンド	説明
`wsh view --magnify file.png`	最大化されたブロックで画像を表示
`wsh view --height=20 file.csv`	特定のブロック高さで表示
Waveにファイルをドラッグ＆ドロップ	ファイルを直接表示
`wsh view .`	現在のディレクトリをブラウズ
`wsh view ~/projects`	特定のディレクトリをブラウズ

カスタマイズ

外観設定

コマンド	説明
設定 → 外観を開く	テーマと色を変更
設定 → ターミナルを開く	フォント、サイズ、カーソルを設定
設定で`term:fontsize`を設定	ターミナルのフォントサイズを設定
設定で`term:fontfamily`を設定	ターミナルのフォントファミリーを設定
設定で`term:theme`を設定	ターミナルのカラーテーマを設定
設定で`term:cursorstyle`を設定	カーソルスタイルを設定（block、bar、underline）
設定で`window:transparent`を設定	ウィンドウの透明度を有効化
設定で`window:blur`を設定	背景ぼかしを有効化
設定で`window:opacity`を設定	ウィンドウの不透明度レベルを設定
`telemetry:enabled = false`を設定	テレメトリを無効化

ターミナル外観の設定

{
  "term:fontsize": 14,
  "term:fontfamily": "JetBrains Mono, Menlo, monospace",
  "term:theme": "dracula",
  "term:cursorstyle": "bar",
  "term:scrollback": 10000,
  "window:transparent": true,
  "window:blur": true,
  "window:opacity": 0.92
}

カスタムテーマの設定

{
  "term:theme": "custom",
  "term:localtheme": {
    "black": "#282a36",
    "red": "#ff5555",
    "green": "#50fa7b",
    "yellow": "#f1fa8c",
    "blue": "#bd93f9",
    "magenta": "#ff79c6",
    "cyan": "#8be9fd",
    "white": "#f8f8f2",
    "brightBlack": "#6272a4",
    "brightRed": "#ff6e6e",
    "brightGreen": "#69ff94",
    "brightYellow": "#ffffa5",
    "brightBlue": "#d6acff",
    "brightMagenta": "#ff92df",
    "brightCyan": "#a4ffff",
    "brightWhite": "#ffffff",
    "background": "#282a36",
    "foreground": "#f8f8f2",
    "cursor": "#f8f8f2",
    "selectionBackground": "#44475a"
  }
}

キーボードショートカット

コマンド	説明
`Cmd/Ctrl + Shift + P`	コマンドパレット
`Cmd/Ctrl + L`	ターミナルをクリア
`Cmd/Ctrl + Shift + E`	サイドバーを切り替え
`Cmd/Ctrl + K`	検索にフォーカス
`Cmd/Ctrl + Shift + F`	グローバル検索
`Alt + 矢印キー`	ブロック間をナビゲート
`Cmd/Ctrl + Enter`	現在のブロックを最大化/復元
`Cmd/Ctrl + ,`	設定を開く

編集とクリップボード

コマンド	説明
`Cmd/Ctrl + Shift + C`	ターミナルからコピー
`Cmd/Ctrl + Shift + V`	ターミナルにペースト
`Cmd/Ctrl + A`	ブロック内をすべて選択
`Cmd/Ctrl + F`	現在のブロック内で検索
`Shift + Page Up`	ターミナルを上にスクロール
`Shift + Page Down`	ターミナルを下にスクロール
`Cmd/Ctrl + Home`	バッファの先頭にスクロール
`Cmd/Ctrl + End`	バッファの末尾にスクロール

ブロック管理

コマンド	説明
`Cmd/Ctrl + D`	垂直に分割
`Cmd/Ctrl + Shift + D`	水平に分割
`Cmd/Ctrl + Backspace`	現在のブロックを閉じる
`Cmd/Ctrl + Enter`	ブロックの最大化を切り替え
`Alt + 上/下/左/右`	ブロック間でフォーカスを移動
`Cmd/Ctrl + Shift + 矢印`	現在のブロックをリサイズ

設定

設定の管理

コマンド	説明
`wsh getvar key`	設定変数を取得
`wsh setvar key=value`	設定変数を設定
`wsh getvar --all`	すべての設定変数を一覧表示
設定は`~/.waveterm/`に保存	デフォルトの設定ディレクトリ
設定で`autoupdate:enabled`を設定	自動更新の有効化/無効化
設定で`conn:askbeforewshinstall`を設定	リモートへのwshインストール前に確認
設定で`editor:minimap`を設定	インラインエディタのミニマップを切り替え
設定で`web:openlinksinternally`を設定	Waveブラウザブロックでリンクを開く

完全な設定例

{
  "term:fontsize": 13,
  "term:fontfamily": "Fira Code, monospace",
  "term:theme": "one-dark",
  "term:cursorstyle": "block",
  "term:scrollback": 5000,
  "window:transparent": false,
  "window:blur": false,
  "telemetry:enabled": false,
  "autoupdate:enabled": true,
  "conn:askbeforewshinstall": true,
  "editor:minimap": false,
  "web:openlinksinternally": true,
  "ai:preset": "openai",
  "ai:model": "gpt-4",
  "ai:maxtokens": 2048
}

環境変数

コマンド	説明
`WAVETERM_HOME=~/.waveterm`	Wave設定ディレクトリを上書き
`WAVETERM_DEV=1`	開発モードを有効化
`TERM_PROGRAM=waveterm`	Waveセッションで自動設定
`WAVETERM_BLOCKID`	現在のブロックID（ブロックごとに設定）
`WAVETERM_TABID`	現在のタブID（タブごとに設定）

ワークスペース管理

ワークスペース

コマンド	説明
サイドバーでワークスペース名をクリック	ワークスペース間を切り替え
ワークスペースを右クリック → リネーム	ワークスペースの名前を変更
サイドバーから新しいワークスペースを作成	新しいワークスペースを追加
ワークスペース間でタブをドラッグ	タブを再整理
ワークスペースは再起動間で永続	すべての状態が自動的に保存

セッションの永続性

コマンド	説明
ターミナル履歴が永続	コマンド出力がセッション間で保存
SSH接続が自動再接続	再起動時にリモートセッションが復元
ブロックレイアウトがタブごとに保存	ペインの配置が保持
作業ディレクトリが記憶される	各ブロックがcwdを記憶
スクロール位置が維持	中断したところから再開

ベストプラクティス

マルチタスクにブロックを使用する — ターミナルをブロックに分割して、ログの監視、ビルドの実行、コードの編集を並べて行いましょう。
不慣れなコマンドにAIを活用する — Cmd/Ctrl + Spaceを押して、構文、フラグ、トラブルシューティングについてAIアシスタントに質問しましょう。
クイックアクセスのためにSSH設定を構成する — すべてのサーバーを~/.ssh/configに追加して、Waveが接続メニューで自動検出できるようにしましょう。
素早い確認にインラインビューアーを使用する — wsh viewでターミナルを離れることなく画像、CSV、Markdownをプレビューできます。
重要なブロックをピン留めする — タスクに集中する時はCmd/Ctrl + Enterで重要なブロックを最大化し、終了したらレイアウトを復元しましょう。
必要に応じてテレメトリを無効化する — プライバシーのために設定でtelemetry:enabledをfalseに設定しましょう。
プロジェクトにワークスペースを使用する — 異なるプロジェクト用に別々のワークスペースを作成して、コンテキストを整理しましょう。
AIモデル設定に-devサフィックスを使用する — ai:baseurlをローカルのOllamaやLM Studioインスタンスに向けて、プライベートでオフラインのAIアシスタンスを実現しましょう。
ブロックのキーボードショートカットを覚える — ナビゲーションのAlt + 矢印と分割のCmd/Ctrl + Shift + Dが最も一般的に使用されるショートカットです。
テーマをカスタマイズする — term:localthemeを使用してカスタムカラーテーマを設定し、好みのエディタの色に合わせて統一感のある体験を得ましょう。

Waveterm

インストール

プラットフォーム別インストール

基本的な使い方

タブとウィンドウの管理

ブロックとペインの管理

AI機能

AIチャット

AIプロバイダー設定

AI設定の例

SSH接続

SSH操作

SSH Config統合

リモートファイルブラウジング

ウィジェットとブロック

ファイルとコンテンツの表示

ブロック操作

ウィジェットの使用パターン

カスタマイズ

外観設定

ターミナル外観の設定

カスタムテーマの設定

キーボードショートカット

ナビゲーション

編集とクリップボード

ブロック管理

設定

設定の管理

完全な設定例

環境変数

ワークスペース管理

ワークスペース

セッションの永続性

ベストプラクティス