Communityコーディング&開発github.com

BladeRunnerYao/codex-voice-to-text-skill

macOS上でローカルのWhisper音声認識を使用したプッシュ・トゥ・トーク方式の音声入力をCodexに追加するスキルです。

codex-voice-to-text-skill とは?

このスキルは、OpenAI Codex CLIエージェントにローカルの音声認識機能を追加し、macOS上でプッシュ・トゥ・トークによる音声入力を可能にします。具体的には、OpenAIのWhisperモデルをローカルで実行し、マイクからの音声をテキストに変換してCodexに送信します。これにより、キーボード入力の代わりに音声でコードの記述や指示ができるようになり、特に長時間のコーディングや手が離せない状況で生産性を向上させます。スキルはPythonスクリプトとして実装されており、ユーザーが設定したホットキーを押している間だけ録音を行い、離すとWhisperで文字起こししてCodexの入力フィールドに自動挿入します。このスキルはmacOS環境向けに特化して設計されており、OpenAI Codex CLIとの連携を前提としています。

対応~Claude Code✓Codex CLI~Cursor
npx skills add BladeRunnerYao/codex-voice-to-text-skill

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

codex-voice-to-text-skill は何をしますか?

macOS上でローカルのプッシュ・トゥ・トークWhisper音声入力を可能にするCodexスキルです。

概要

このスキルは、OpenAI Codex CLIエージェントにローカルで動作する音声認識機能を追加します。 ユーザーがホットキーを押している間だけマイクから音声を録音し、キーを離すとOpenAI Whisperモデルを使って文字起こしを行い、そのテキストをCodexの入力として送信します。

特徴

  • ローカル実行: すべての音声認識がローカルで行われるため、ネットワーク待ち時間がなくプライバシーも保護されます。
  • プッシュ・トゥ・トーク: 直感的なホットキー操作で録音の開始・停止を制御します。
  • macOS対応: macOS環境に最適化されています。
  • Codex連携: 文字起こし結果をCodex CLIエージェントに直接送信します。

前提条件

  • macOS環境
  • Python 3.8以上
  • OpenAI Whisper(ローカルインストール済み)
  • OpenAI Codex CLI(セットアップ済み)

インストール方法

# このリポジトリをクローン
git clone https://github.com/BladeRunnerYao/codex-voice-to-text-skill.git
cd codex-voice-to-text-skill

# 依存関係をインストール
pip install -r requirements.txt

使い方

  1. スキルを起動します。
  2. 設定されたホットキー(デフォルトではCtrl+Shift+Vなど)を押し続けます。
  3. マイクに向かって話します。
  4. ホットキーを離すと、Whisperが音声をテキストに変換します。
  5. 変換されたテキストが自動的にCodexの入力に挿入されます。

カスタマイズ

ホットキーやWhisperのモデルサイズ、録音デバイスなどの設定は、config.yamlファイルを編集して変更できます。

注意事項

  • 初回起動時にはWhisperモデルのダウンロードが行われる場合があります。
  • マイクのアクセス許可をmacOSのプライバシー設定で有効にする必要があります。

ライセンス

このプロジェクトはMITライセンスの下で公開されています。

関連スキル