Windows ターミナル環境
Windows 標準の従来コンソール（cmd.exe / conhost）は、既定のフォントに emoji や Nerd Font のアイコン字形が含まれず、 トゥルーカラーにも対応していません。そのため zqagent はここでは簡易表示に切り替わります：✅ は [OK]、表の罫線は ASCII に退化し、 色もくすんで見えます。機能に影響はありませんが、Linux / macOS と比べると見劣りします。
このページでは推奨設定と、zqagent 内蔵の自動ガイドを説明します。
推奨設定
| 層 | 推奨 | 説明 |
|---|---|---|
| ターミナル | Windows Terminal | トゥルーカラー、GPU アクセラレーション、タブと分割表示。cmd / PowerShell / WSL を同時に扱える |
| フォント | Nerd Font（等幅） | アイコン字形を補完。例：JetBrainsMono Nerd Font |
| Shell | PowerShell 7 または Git Bash | スクリプト体験が Linux に近い |
| プロンプト | oh-my-posh / starship | アイコン付きプロンプトと git 状態 |
1. Windows Terminal をインストール
方法 A（推奨。Win10 1809+ は winget 内蔵）：
winget install --id Microsoft.WindowsTerminal -e --accept-source-agreements --accept-package-agreements方法 B：「Microsoft Store」を開き、Windows Terminal を検索してインストール。
2. Nerd Font をインストール
winget install --id DEVCOM.JetBrainsMonoNerdFont -e --accept-source-agreements --accept-package-agreements同等のフォントはどれでも可（パッケージ名は winget search nerd で確認）：CaskaydiaCove Nerd Font、 FiraCode Nerd Font、Hack Nerd Font。Nerd Fonts 公式サイト からダウンロードし、 解凍後にフォントファイルを右クリック →「すべてのユーザーにインストール」でも構いません。
注意：Nerd Font は通常の
JetBrains Monoとは別物です。インストール後、ターミナルで**Nerd Fontが付くもの**を選ばないと、アイコンは四角のままです。
3. 既定のターミナルに設定
Windows Terminal → 設定 → スタートアップ →「既定のターミナルアプリケーション」→ Windows Terminal を選択。 以後、cmd.exe / PowerShell から起動しても Windows Terminal に入ります。
4. Windows Terminal でフォントを選択
設定 → プロファイル → 既定値 → 外観 → フォント → JetBrainsMono Nerd Font を選択。
settings.json を直接編集してもかまいません：
{
"profiles": {
"defaults": {
"font": { "face": "JetBrainsMono Nerd Font", "size": 11 }
}
}
}5. shell を使いやすく（任意）
winget install --id Microsoft.PowerShell -e # PowerShell 7
winget install --id JanDeDobbeleer.OhMyPosh -e # oh-my-posh プロンプトzqagent の動作
- 起動時にターミナル能力を検出し、emoji / Unicode 非対応なら自身の出力を自動で ASCII 表記に切り替えます （
✅→[OK]、❌→[x]、⚠️→[!]）。Markdown の表も ASCII 罫線になります。 - 従来コンソールを検出すると積極的に案内します：まず agent に winget で自動インストールさせるかを尋ねます （Windows Terminal と Nerd Font。コマンドは 1 つずつ承認を通ります）。インストールできない場合や LLM 接続が未設定の場合は、 手動インストールの手順を表示します。
- 関連する環境変数：
| 変数 | 作用 |
|---|---|
ZQAGENT_TERM_SETUP=0 | 起動時のターミナル環境ガイドを無効化 |
ZQAGENT_TERM_SETUP=1 | ガイドを強制表示（手順のプレビューに便利） |
ZQAGENT_EMOJI=1/0 | emoji と Unicode 表を強制的に有効化 / 無効化 |
ZQAGENT_ASCII=1 | ASCII 表記に強制降格 |
トラブルシューティング
| 現象 | 対処 |
|---|---|
winget がない | 「Microsoft Store」で「アプリ インストーラー」(App Installer) を検索してインストールするか、方法 B を使う |
| アイコンが四角のまま | ターミナルで選んだフォントが Nerd Font ではない |
emoji が ? のまま | Windows Terminal で実行しているか、ZQAGENT_EMOJI が 0 になっていないか確認 |
| 色がくすむ | conhost はトゥルーカラー非対応。Windows Terminal に切り替える |