/add-listen-hotkey

OSの任意の場所から deus listen をトリガーするグローバルホットキーをインストールします。 すべての必要な依存関係(sox、whisper-cli)をインストールし、whisperモデルをダウンロードします。

ステップ 1 — 依存関係とwhisperモデルのインストール

ユーザーにホットキーの設定について質問する前に、以下のチェックとインストールを実行してください。

依存関係

macOS:

# soxのチェック
command -v sox || brew install sox

# whisper-cli のチェック (whisper-cpp から)
command -v whisper-cli || brew install whisper-cpp

Linux:

# soxのチェック
command -v sox || sudo apt install -y sox libsox-fmt-all

# whisper-cli — apt に未対応の場合、ソースからビルド
if ! command -v whisper-cli; then
  echo "whisper-cli が見つかりません。ビルドしてください: https://github.com/ggerganov/whisper.cpp"
  echo "ビルド後、'whisper-cli' が PATH に存在することを確認してください。"
  # 続行前にユーザーに確認をさせる
fi

Windows:

# soxのチェック
if (-not (Get-Command sox -ErrorAction SilentlyContinue)) {
  winget install sharkdp.bat  # または: choco install sox.portable
}

# whisper-cli のチェック
if (-not (Get-Command whisper-cli -ErrorAction SilentlyContinue)) {
  Write-Host "whisper-cli をここからダウンロード: https://github.com/ggerganov/whisper.cpp/releases"
  Write-Host "PATH に追加してから、このスキルを再実行してください。"
  # 停止してユーザーの対応を待つ
}

Whisperモデル

WHISPER_MODEL 環境変数からモデルパスを解決するか、以下のいずれかをデフォルトとします: ~/deus/data/models/ggml-large-v3-turbo.bin (Liamの個人設定) または ~/deus/data/models/ggml-base.bin (公開デフォルト)

モデルファイルが存在しない場合はダウンロードします:

MODEL_PATH="${WHISPER_MODEL:-$HOME/deus/data/models/ggml-base.bin}"
MODEL_URL="https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.bin"

if [ ! -f "$MODEL_PATH" ]; then
  mkdir -p "$(dirname "$MODEL_PATH")"
  echo "whisperモデル(148 MB)をダウンロード中..."
  curl -L --progress-bar -o "$MODEL_PATH" "$MODEL_URL"
  echo "モデルを保存しました: $MODEL_PATH"
fi

ggml-large-v3-turbo.bin の場合(高精度、1.5 GB):

https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo.bin

WHISPER_MODEL がまだ設定されていない場合、ユーザーにどのモデルを使用するか確認してください:

• base (148 MB、高速、英語に適している) — デフォルト
• large-v3-turbo (1.5 GB、最高精度、ヘブライ語向け推奨)

~/.zshrc / ~/.bashrc / Windows ユーザー環境変数に WHISPER_MODEL を設定して、 deus listen が毎回指定しなくても常にモデルを見つけられるようにします。

エンドツーエンド検証

ホットキーをインストールする前に、簡単なスモークテストを実行します:

DEUS_LISTEN_NO_CLIPBOARD=1 node ~/deus/dist/deus-listen.js --help 2>/dev/null || \
  echo "ビルドが必要です — 実行してください: cd ~/deus && npm run build"

ビルドが不足している場合は、続行する前に ~/deus で npm run build を実行してください。

ステップ 2 — OS を検出し、ホットキー設定について質問

OSを検出します(platform.ts コンテキストから IS_MACOS / IS_LINUX / IS_WINDOWS、または uname -s を実行)。

ユーザーに質問します:

1. ホットキー — デフォルト: Cmd+Option+V (macOS) / Super+Alt+V (Linux) / Ctrl+Alt+V (Windows)
2. モード:
   • silent (デフォルト) — deus listen をバックグラウンドで実行し、完了時に通知
   • terminal — VUメーター表示付きで新しいターミナルウィンドウを開く
3. ストリームモード? — はいの場合、シングルショットの代わりに deus listen --stream を使用

ステップ 3 — OS ごとにインストール

macOS — Hammerspoon

Hammerspoon がインストール済みか確認: ls /Applications/Hammerspoon.app 2>/dev/null インストール済みでない場合: brew install --cask hammerspoon (ユーザーの承認を取得)。

~/.hammerspoon/deus-listen.lua を作成:

-- deus listen hotkey (Deus /add-listen-hotkey により管理)
local mods = {"cmd", "alt"}
local key  = "v"

hs.hotkey.bind(mods, key, function()
  -- サイレントモード: ヘッドレスで実行、完了時に通知
  local task = hs.task.new("/bin/zsh", function(code, stdout, stderr)
    local msg = code == 0 and "クリップボードにコピーしました" or "文字起こしに失敗しました"
    hs.notify.new({title = "Deus", informativeText = msg}):send()
  end, {"-lc", "deus listen --no-clipboard=false"})
  task:start()
  hs.notify.new({title = "Deus", informativeText = "リッスン中…"}):send()
end)

ターミナルモードの場合は、タスク本体を以下に置き換えます:

  hs.execute("open -a Ghostty --args -e 'deus listen'")

(Ghostty が存在しない場合は iTerm2 / Terminal.app を使用 — ls /Applications/Ghostty.app で検出)。

~/.hammerspoon/init.lua からファイルをソースします:

-- Deus /add-listen-hotkey により自動追加
require("deus-listen")

Hammerspoon をリロード: open -g hammerspoon://reloadConfig

Linux — sxhkd

sxhkd が実行中か確認: pgrep sxhkd インストール済みでない場合: sudo apt install sxhkd (または pacman/dnf 相当)。

~/.config/sxhkd/sxhkdrc に追記(存在しない場合は作成):

# deus listen (Deus /add-listen-hotkey により管理)
super + alt + v
    deus listen

ストリームモードの場合: deus listen を deus listen --stream に置き換えます。

リロード: pkill -USR1 sxhkd

ターミナルモード(VUメーター表示):

super + alt + v
    ghostty -e deus listen

Windows — AutoHotkey v2

AHK がインストール済みか確認: Get-Command autohotkey.exe -ErrorAction SilentlyContinue インストール済みでない場合: winget install AutoHotkey.AutoHotkey

%APPDATA%\deus\deus-listen.ahk を作成:

; deus listen hotkey (Deus /add-listen-hotkey により管理)
^!v:: {  ; Ctrl+Alt+V
    Run "deus listen", , "Hide"
}

ターミナルモード: Run "wt.exe deus listen" (Windows Terminal)。

スタートアップに追加: %APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\ にショートカットを作成。

すぐに実行: Start-Process autohotkey.exe "$env:APPDATA\deus\deus-listen.ahk"

ステップ 4 — 検証

ホットキーをテストします:

• macOS: トリガーし、「リッスン中…」通知を待ち、話しかけて、クリップボードを確認。
• Linux: トリガー、話しかけ、xclip -o -selection clipboard でクリップボードを確認。
• Windows: トリガー、話しかけ、Get-Clipboard でクリップボードを確認。

ステップ 5 — アンインストール手順(ユーザーに表示)

• macOS: ~/.hammerspoon/deus-listen.lua を削除し、init.lua から require 行を削除し、Hammerspoon をリロード。
• Linux: ~/.config/sxhkd/sxhkdrc から追記したブロックを削除し、pkill -USR1 sxhkd を実行。
• Windows: %APPDATA%\deus\deus-listen.ahk とスタートアップショートカットを削除。