いつものターミナルに、あなたのAquaを。

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

brew install aqua-voice/tap/aqua

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

まとめて追加するには、インポートとエクスポート.

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アカウントに送られ、すべての端末で次の音声入力から適用されます。デスクトップアプリでは数秒以内に一覧へ反映されます。そのページを開くには：

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をエクスポートに付けます。

文字起こしにはAPIキーが必要です。 APIダッシュボードで作成し、求められたら貼り付けてください：

aqua auth login --with-api-key

環境変数として次を設定することもできます：AQUA_API_KEY。文字起こしには、 Aqua APIを使い、音声1時間あたり0.39ドル、最低10秒分で課金されます。最初の1ドル分は無料です。

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

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 -

ターミナルでは人が読みやすい形式、パイプでは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 claude

Codexでは、aqua setup codex. After aqua updateの後、再実行するとスキルを最新版にできます。

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 transcribe <file>… | -

音声ファイル、または標準入力の音声を文字起こします。

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

Success

1

Error

2

辞書にない単語など、対象が見つからない

3

未サインイン、認証期限切れ、またはAPIキー・トークンが無効。詳細はエラーに表示されます。

4

使い方のエラー：コマンド、フラグ、引数、入力が不正

5

レート制限または請求の問題。対処法はエラーに表示されます。

6

ネットワークエラー：サーバーに接続できない

7

文字起こしにはAPIキーが必要。再サインインでは解決しない

130

Ctrl-Cで中断（macOS・Linux）