Aqua CLIリファレンス

ターミナルやコーディングエージェントから、会議と音声入力の履歴を読み、音声入力に使う語彙と指示を変更し、音声ファイルを文字に起こせます。

インストール

macOS・Linux:

Shell
curl -fsSL https://aquavoice.com/install-cli | sh

Homebrew:

Shell
brew install aqua-voice/tap/aqua

Windows:

PowerShell
powershell -c "irm https://aquavoice.com/install-cli.ps1 | iex"

最新版に更新するには、aqua updateを実行します。Homebrewで入れた場合は、 brew upgrade aqua-voice/tap/aqua instead.

ログイン

Shell
aqua auth login

ブラウザーが開きます。SSH経由、または--no-browser, aquaを使う場合はURLとコードが表示されます。任意の端末のブラウザーでURLを開き、コードを入力してください。

現在のアカウントを確認するには、aqua auth statusを実行します。サインアウトは、 aqua auth logoutです。音声の文字起こしにはAPIキーも必要です。詳しくは、 音声を文字起こし.

辞書

名前、製品用語など、意図した表記で入力してほしい単語を登録します。

Shell
aqua dict add Siobhan Kubernetes "Hacker News"

引数1つが1件の登録になります。大文字・小文字を区別せず、登録済みの単語は読み飛ばします。一覧の表示は、 aqua dict listです。削除するには、 aqua dict remove Kubernetes.

単語1つなら引用符は不要です。空白を含む語句には引用符を付けてください。付けないとシェルが複数の項目に分けます。引用符はシェル用で、Aquaには保存されません。文字列に $, !やバッククォートがある場合は、二重引用符内でシェルが解釈するため、一重引用符を使います。同じ規則が、removeと置換にも適用されます。

Shell
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つ目の語句を入力します。

Shell
aqua replacements add "my email" "maya@northstar.studio"

同じ語句の置換があれば更新します。一覧の表示は、 aqua replacements listです。削除するには、 aqua replacements remove "my email".

カスタム指示

音声入力をどのように文章にするか指定します。

Shell
aqua instructions edit

指示が次のエディターで開きます:$VISUAL or $EDITOR。保存して閉じると変更が適用されます。編集中に別の端末で変更された場合、 aquaは上書きせず、あなたの編集をファイルに残して保存場所を表示します。

エディターを使わず1行追加するには:

Shell
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.

設定

音声入力の言語と、カジュアルなメッセージの設定です。

Shell
aqua settings set language de

言語を自動で検出させるには、言語コードの代わりにautoを指定します。

カジュアルなメッセージがオンだと、短いメッセージをくだけた文体で入力します。オフにするには:

Shell
aqua settings set casual-messaging off

aqua settings getで設定を表示します。

変更の同期

変更はAquaアカウントに送られ、すべての端末で次の音声入力から適用されます。デスクトップアプリでは数秒以内に一覧へ反映されます。そのページを開くには:

Shell
aqua app dictionary

ほかのページには、replacementsおよびcustom-instructions. Run aqua app --helpで全一覧を確認できます。

デスクトップアプリが未インストールの場合、aqua appは次のページを開きます: ダウンロードページ。SSH経由では、--printを付けるとリンクを表示するだけになります。

インポートとエクスポート

複数の項目を一括追加したり、登録内容をバックアップしたりできます。

Shell
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)、実際には変更しません。

Shell
aqua dict import words.txt --replace --dry-run

バックアップはJSONにエクスポートします。インポートで読み戻せます。

Shell
aqua dict export > dictionary.json
aqua replacements export > replacements.json

ほかの形式では、--format txt or --format csvをエクスポートに付けます。

音声を文字起こし

Aquaの音声モデルAvalonで、音声ファイルを文章にします。

文字起こしにはAPIキーが必要です。 APIダッシュボード, then run:

Shell
aqua auth login --with-api-key

Press 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ドル分は無料です。

次にファイルを文字起こします。結果はターミナルに出るため、リダイレクトで保存できます:

Shell
aqua transcribe memo.m4a > memo.txt

flac、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.m4a becomes transcripts/memo.txt.
--language de
自動検出の代わりに、話している言語を指定します。
--prompt "Siobhan, Kubernetes"
正しく認識してほしい名前や専門用語を指定します。
--jobs 5
最大5ファイルを同時に処理します。既定は3です。
-
標準入力から音声を読み取ります:curl -sL https://example.com/talk.mp3 | aqua transcribe -

音声入力の履歴

どのアプリで音声入力した内容でも探せます。

Shell
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キーでは会議を読めません。

Shell
aqua meetings list --query pricing --since 7d
aqua meetings show 7

会議は、番号(7など)、mtg_ID、アプリのリンク、共有リンクのどれでも指定できます。showは、タイトル、日時、長さ、参加者、メモを表示します。メモがない会議では、文字起こしの最初の60行を表示します。

--trashはゴミ箱の会議を一覧表示します。--sharedは、ほかの人があなたと共有した会議を一覧表示します。ほかの絞り込み条件は、aqua meetings list --helpで確認できます。

文字起こしの全文を取得するには:

Shell
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ページにまとめたものです。

Shell
aqua meetings notes append 7 "Send Dana the pricing deck by Friday."

メモのコマンドは、カスタム指示のコマンドと同じように使えます。editはメモをエディターで開きます。編集中にメモが変更された場合、aquaはその変更を上書きしません。

aqua meetings summarize 7 --yesは新しい要約を作ります。今ある要約のテキストは置き換わります。--yesを付けないと、先に確認します。スクリプトではエラーで止まります。

会議の共有と整理

ほとんどはすぐに反映されます。リンクを誰でも開けるようにするときと、新しいリンクを作るときは、先に確認します。

aqua meetings speakers name 7 "Speaker 2" "Dana Lee"
話者に名前を付けます。speakers listで各話者と最初の発言を表示し、 aqua meetings renameで会議のタイトルを変更します。
aqua meetings delete 7
会議をゴミ箱に移動します。aqua meetings restore 7で、30日以内なら元に戻せます。
aqua meetings share 7
共有リンクと、リンクを開ける人を表示します。--accessで、開ける人を設定します: private(あなたと招待した人だけ)、organization(ビジネスワークスペースのメンバーも)、またはlink(リンクを知っている全員)。 --reset-linkは新しいリンクを作り、古いリンクを無効にします。リンクを誰でも開けるようにするときと、新しいリンクを作るときは、先に確認します。スクリプトでは、--yesで確認を省略できます。
aqua meetings invite 7 dana@northstar.studio
Danaにリンクをメールで送ります。そのメールアドレスでサインインすると、メモ、文字起こし、スクリーンショットを読めます。--messageで短いメッセージを添えられます。 aqua meetings uninviteでアクセスを取り消します。
aqua meetings folders add Customers 7
会議をフォルダーに入れます。フォルダーで他の人にアクセス権が付くことはありません。aqua meetings folders --help で、フォルダーの一覧、作成、名前の変更、削除の方法を確認できます。
aqua meetings people add "Dana Lee" --email dana@northstar.studio
会議の参加者に人を追加します。people listで名前から人を探し、 people updateで名前やメールアドレスを変更し、people remove で確認のあとに人を削除します。

スクリプトとCI

ターミナルでは人が読みやすい形式、パイプでは1行1値、またはヘッダーなしのタブ区切りになります。値に含まれるタブ、改行、バックスラッシュは、\t, \n、および\\と表示し、各行を1行に保ちます。状態メッセージは標準エラー出力に送るため、データと混ざりません。-qで非表示にできます。

Shell
aqua dict list | wc -l
aqua replacements list | cut -f1

--jsonはJSONを出力します。--jqで絞り込みできます。jqのインストールは不要です:

Shell
aqua dict list --json
aqua replacements list --jq '.replacements[].from'

transcribe --jsonは、--jsonの中で一覧を返すコマンドです。ファイル数にかかわらず、順番どおりに1ファイル1件を返します。失敗したファイルには、error に終了コードとメッセージが入り、textはありません。--jq フィルターに失敗すると、絞り込み前の一覧を出力し、終了コードは0以外になります。不正なファイルやAPIキー未設定などで1件も開始できなければ、標準出力は空になり、終了コードで理由を示します:

Shell
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."

Shell
aqua setup claude

Codexでは、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)