Aqua CLIリファレンス
ターミナルやコーディングエージェントから、会議と音声入力の履歴を読み、音声入力に使う語彙と指示を変更し、音声ファイルを文字に起こせます。
インストール
macOS・Linux:
curl -fsSL https://aquavoice.com/install-cli | shHomebrew:
brew install aqua-voice/tap/aquaWindows:
powershell -c "irm https://aquavoice.com/install-cli.ps1 | iex"最新版に更新するには、aqua updateを実行します。Homebrewで入れた場合は、 brew upgrade aqua-voice/tap/aqua instead.
ログイン
aqua auth loginブラウザーが開きます。SSH経由、または--no-browser, aquaを使う場合はURLとコードが表示されます。任意の端末のブラウザーでURLを開き、コードを入力してください。
現在のアカウントを確認するには、aqua auth statusを実行します。サインアウトは、 aqua auth logoutです。音声の文字起こしにはAPIキーも必要です。詳しくは、 音声を文字起こし.
辞書
名前、製品用語など、意図した表記で入力してほしい単語を登録します。
aqua dict add Siobhan Kubernetes "Hacker News"引数1つが1件の登録になります。大文字・小文字を区別せず、登録済みの単語は読み飛ばします。一覧の表示は、 aqua dict listです。削除するには、 aqua dict remove Kubernetes.
単語1つなら引用符は不要です。空白を含む語句には引用符を付けてください。付けないとシェルが複数の項目に分けます。引用符はシェル用で、Aquaには保存されません。文字列に $, !やバッククォートがある場合は、二重引用符内でシェルが解釈するため、一重引用符を使います。同じ規則が、removeと置換にも適用されます。
aqua dict add Kubernetes # one word: no quotes
aqua dict add "Hacker News" # a phrase: one entry
aqua dict add Hacker News # no quotes: two entries, Hacker and News
aqua dict add "Ben's Diner" # an apostrophe: use double quotes
aqua dict add 'Ca$h App' # $, !, or a backtick: use single quotesまとめて追加するには、インポートとエクスポート.
置換
最初の語句を聞くと、2つ目の語句を入力します。
aqua replacements add "my email" "maya@northstar.studio"同じ語句の置換があれば更新します。一覧の表示は、 aqua replacements listです。削除するには、 aqua replacements remove "my email".
カスタム指示
音声入力をどのように文章にするか指定します。
aqua instructions edit指示が次のエディターで開きます:$VISUAL or $EDITOR。保存して閉じると変更が適用されます。編集中に別の端末で変更された場合、 aquaは上書きせず、あなたの編集をファイルに残して保存場所を表示します。
エディターを使わず1行追加するには:
aqua instructions append "Write ticket IDs like ENG-142 in uppercase."aqua instructions getで指示を表示します。 aqua instructions set "Use British spelling."ですべてを置き換え、 aqua instructions clearで削除します。実行前に確認します。スクリプトでは、 --yes. setおよびappendは、引数に-を渡すと標準入力を読みます。例: aqua instructions set - < instructions.md.
設定
音声入力の言語と、カジュアルなメッセージの設定です。
aqua settings set language de言語を自動で検出させるには、言語コードの代わりにautoを指定します。
カジュアルなメッセージがオンだと、短いメッセージをくだけた文体で入力します。オフにするには:
aqua settings set casual-messaging offaqua settings getで設定を表示します。
変更の同期
変更はAquaアカウントに送られ、すべての端末で次の音声入力から適用されます。デスクトップアプリでは数秒以内に一覧へ反映されます。そのページを開くには:
aqua app dictionaryほかのページには、replacementsおよびcustom-instructions. Run aqua app --helpで全一覧を確認できます。
デスクトップアプリが未インストールの場合、aqua appは次のページを開きます: ダウンロードページ。SSH経由では、--printを付けるとリンクを表示するだけになります。
インポートとエクスポート
複数の項目を一括追加したり、登録内容をバックアップしたりできます。
aqua dict import words.txtファイル内の項目を追加し、既存の項目も残します。置換の場合は、 aqua replacements importを使います。ファイル形式は拡張子で判定します:
- .txt
- 辞書:1行に1つの単語または語句を記載します。行全体が
#の場合や、行頭が#の場合はコメントとして扱います。そのため、#generalなどの単語も登録できます。置換では、各行にfrom、タブ、までの順で記載します。 - .csv
- 辞書:最初の列に単語を記載します。置換:各行を
from,toとします。先頭のfrom,toヘッダー行は読み飛ばします。 - .tsv
- .csvと同じ形式で、列をタブで区切ります。
- .json
- What
exportの出力形式です。単語のJSON配列、または{"from": …, "to": …}オブジェクトの配列も使えます。
一覧をファイルと完全に一致させるには、--replaceを付けます。ファイルにない項目は削除されるため、実行前に確認します。スクリプトでは、--yesを付けます。変更内容を先に見るには、--dry-runを付けます。変更ごとに1行を表示し(例: + Siobhan or - Kubernetes)、実際には変更しません。
aqua dict import words.txt --replace --dry-runバックアップはJSONにエクスポートします。インポートで読み戻せます。
aqua dict export > dictionary.json
aqua replacements export > replacements.jsonほかの形式では、--format txt or --format csvをエクスポートに付けます。
音声を文字起こし
Aquaの音声モデルAvalonで、音声ファイルを文章にします。
文字起こしにはAPIキーが必要です。 APIダッシュボード, then run:
aqua auth login --with-api-keyPress Return. At Paste your API key:, paste the key and press Return again. Input is hidden.
For scripts and CI, pipe the key to --with-api-key or set AQUA_API_KEY.
Transcription uses the Aqua APIを使い、音声1時間あたり0.39ドル、最低10秒分で課金されます。最初の1ドル分は無料です。
次にファイルを文字起こします。結果はターミナルに出るため、リダイレクトで保存できます:
aqua transcribe memo.m4a > memo.txtflac、m4a、mp3、mp4、mpeg、mpga、ogg、wav、webmに対応し、1ファイル25 MB以下、1時間未満です。複数のファイルも渡せます。例:aqua transcribe *.mp4 --format srt --out subtitles/。その他のオプション:
- --format srt
- 字幕。他の形式は
text(既定)、json,verbose_json(セグメントのタイムスタンプ付き)、vtt. - --out transcripts/
- ターミナルではなく、ファイルに書き出します:
memo.m4abecomestranscripts/memo.txt. - --language de
- 自動検出の代わりに、話している言語を指定します。
- --prompt "Siobhan, Kubernetes"
- 正しく認識してほしい名前や専門用語を指定します。
- --jobs 5
- 最大5ファイルを同時に処理します。既定は3です。
- -
- 標準入力から音声を読み取ります:
curl -sL https://example.com/talk.mp3 | aqua transcribe -
音声入力の履歴
どのアプリで音声入力した内容でも探せます。
aqua history list --app Slack --since 2d--queryで、その語句を含む音声入力を探します。--since および--untilには、2026-11-01のような日付、時刻、または 12h(12時間)のような経過時間を指定できます。
1件の音声入力の最終テキストと認識結果をそのまま見るには、一覧のIDを付けてaqua history showを実行します。aqua history screenshots <id> -o shots/で、ペンで撮ったスクリーンショットを保存します。
会議
Aquaが記録した会議を探し、読み、保存します。
会議のコマンドは、aqua auth loginでサインインしたアカウントを使います。APIキーでは会議を読めません。
aqua meetings list --query pricing --since 7d
aqua meetings show 7会議は、番号(7など)、mtg_ID、アプリのリンク、共有リンクのどれでも指定できます。showは、タイトル、日時、長さ、参加者、メモを表示します。メモがない会議では、文字起こしの最初の60行を表示します。
--trashはゴミ箱の会議を一覧表示します。--sharedは、ほかの人があなたと共有した会議を一覧表示します。ほかの絞り込み条件は、aqua meetings list --helpで確認できます。
文字起こしの全文を取得するには:
aqua meetings transcript 7 > call.txt各行に時刻と話者が入ります。例:[0:12] Me: Can we ship on Friday?
--format srtは字幕を、--format jsonはJSONを出力します。aqua meetings screenshots 7 -o shots/は、ペンで撮ったスクリーンショットをPNGファイルとして保存します。
議事録
あなたのメモとAquaの要約を、1ページにまとめたものです。
aqua meetings notes append 7 "Send Dana the pricing deck by Friday."メモのコマンドは、カスタム指示のコマンドと同じように使えます。editはメモをエディターで開きます。編集中にメモが変更された場合、aquaはその変更を上書きしません。
aqua meetings summarize 7 --yesは新しい要約を作ります。今ある要約のテキストは置き換わります。--yesを付けないと、先に確認します。スクリプトではエラーで止まります。
スクリプトとCI
ターミナルでは人が読みやすい形式、パイプでは1行1値、またはヘッダーなしのタブ区切りになります。値に含まれるタブ、改行、バックスラッシュは、\t, \n、および\\と表示し、各行を1行に保ちます。状態メッセージは標準エラー出力に送るため、データと混ざりません。-qで非表示にできます。
aqua dict list | wc -l
aqua replacements list | cut -f1--jsonはJSONを出力します。--jqで絞り込みできます。jqのインストールは不要です:
aqua dict list --json
aqua replacements list --jq '.replacements[].from'transcribe --jsonは、--jsonの中で一覧を返すコマンドです。ファイル数にかかわらず、順番どおりに1ファイル1件を返します。失敗したファイルには、error に終了コードとメッセージが入り、textはありません。--jq フィルターに失敗すると、絞り込み前の一覧を出力し、終了コードは0以外になります。不正なファイルやAPIキー未設定などで1件も開始できなければ、標準出力は空になり、終了コードで理由を示します:
aqua transcribe *.m4a --json
# [{"file": "a.m4a", "text": "..."},
# {"file": "b.m4a", "error": {"code": 1, "message": "..."}}]
aqua transcribe *.m4a --jq '.[].text'CIでは、AQUA_API_KEYにAPIキーを設定し、サインインの代わりに使います。コマンドの結果は、終了コード.
コーディングエージェント
エージェントに使い方を教えるスキルをインストールします。対象は、aqua. Then you can ask it things like "add the names in this doc to my Aqua dictionary."
aqua setup claudeCodexでは、aqua setup codex. After aqua updateの後、再実行するとスキルを最新版にできます。
Commands
- aqua auth login | status | logout
- サインイン、アカウントの確認、サインアウト。
login --with-api-keyはAPIキーを尋ねるか、標準入力から読み取ります。 - aqua dict list | add | remove | import | export
- 辞書を管理します。
- aqua replacements list | add | remove | import | export
- 置換を管理します。
- aqua instructions get | set | append | edit | clear
- カスタム指示を管理します。
- aqua settings get | set
- 音声入力の言語とカジュアルなメッセージの設定を確認・変更します。
- aqua transcribe <file>… | -
- 音声ファイル、または標準入力の音声を文字起こします。
- aqua history list | show | screenshots
- 過去の音声入力を検索し、そのスクリーンショットを保存します。
- aqua meetings list | show | transcript | screenshots
- 会議を探して読みます。
- aqua meetings notes get | set | append | edit
- 会議のメモを変更します。
- aqua meetings summarize <meeting> --yes
- 会議の要約を作り直します。
- aqua meetings rename | speakers
- 会議のタイトルを変更し、話者に名前を付けます。
- aqua meetings delete | restore
- 会議をゴミ箱に移動するか、ゴミ箱から戻します。
- aqua meetings share | invite | uninvite
- 会議を開ける人を選びます。
- aqua meetings folders | people
- 会議をフォルダーに整理し、参加者を追加・変更・削除します。
- aqua app [page]
- デスクトップアプリを開きます。ページ名を指定すれば、そのページを開きます。未インストールの場合はダウンロードページを開きます。
- aqua setup claude | codex
- コーディングエージェント用のAquaスキルをインストールします。
- aqua update
- Aquaを最新バージョンに更新します。
- aqua version
- Aquaのバージョンを表示します。
- aqua completion <shell>
- bash、zsh、fish、powershell向けの補完スクリプトを出力します。
実行するコマンド:aqua <command> --helpでフラグと使用例を確認できます。
終了コード
- 0
- 成功
- 1
- エラー
- 2
- 辞書にない単語など、対象が見つからない
- 3
- 未サインイン、認証期限切れ、またはAPIキー・トークンが無効。詳細はエラーに表示されます。
- 4
- 使い方のエラー:コマンド、フラグ、引数、入力が不正
- 5
- レート制限または請求の問題。対処法はエラーに表示されます。
- 6
- ネットワークエラー:サーバーに接続できない
- 7
- 文字起こしにはAPIキーが必要。再サインインでは解決しない
- 130
- Ctrl-Cで中断(macOS・Linux)