CLIオプション

使い方

yaku [オプション] [テキスト]

テキストは位置引数、-f（ファイル）、またはstdinパイプで指定できます。詳しくは入出力をご覧ください。

翻訳オプション

オプション	型	デフォルト	説明
--to	string	設定のdefault-target	必須。 ターゲット言語コード（例: ja、zh-TW、en）。
--from	string	自動検出	ソース言語コード。省略するとLLMが自動検出します。
--mode	string	translate	translate — ターゲット言語に翻訳。polish — すでにターゲット言語にある文章を推敲。推敲モードを参照。
--context	string		LLMへのドメインヒント（例: "Kubernetesドキュメント"、"フォーマルなメール"）。曖昧な用語の解決に役立ちます。

入出力オプション

オプション	短縮	型	デフォルト	説明
--file	-f	string[]		入力ファイルパス。複数ファイルの場合は繰り返し：-f a.md -f b.md。
--output	-o	string	stdout	stdoutの代わりにファイルに翻訳テキストを書き込み。
--format		string	自動検出	入力フォーマットの強制：text、md、json、yaml。省略時は-fのファイル拡張子から自動検出。

バックエンドオプション

オプション	型	デフォルト	説明
--backend	string	hosted	LLMバックエンド：hosted、gemini、openai、anthropic。バックエンドを参照。
--model	string	backendのデフォルト	モデル名の上書き（例: gemini-2.5-flash、gpt-4o、claude-sonnet-4-5-20250514）。
--api-base	string		ローカルバックエンド用の API ベース URL オーバーライド。OpenAI 互換プロバイダーでよく使用（例: https://api.groq.com/openai/v1）。

用語集オプション

オプション	型	デフォルト	説明
--glossary	string	自動検出	用語集YAMLファイルのパス。自動検出を上書き。用語集を参照。
--no-glossary	bool	false	デフォルトの場所に用語集ファイルがあっても、用語集の読み込みを完全にスキップ。

プロンプトオプション

オプション	型	デフォルト	説明
--prompt	string	組み込み	カスタムシステムプロンプトファイルのパス。組み込みプロンプト全体を置き換えます。カスタムプロンプトを参照。

診断オプション

オプション	型	デフォルト	説明
--verbose	bool	false	翻訳後にモデル名、トークン数、経過時間をstderrに表示。

--verboseの出力例（stderr）：

Model: gemini-2.5-flash | Tokens: 42 in / 38 out | Time: 1.2s

サブコマンド

yaku config

~/.config/yaku/config.yamlの設定ファイルを管理します。

コマンド	説明
yaku config set <key> <value>	設定値を設定。
yaku config get <key>	設定値を読み取り（ファイルのみ、環境変数は反映されません）。
yaku config path	設定ファイルのパスを表示。

利用可能なすべてのキーは設定をご覧ください。

yaku login

ブラウザベースのデバイス認証フローを使ってホステッドサービスに認証します。ブラウザが事前入力された認証コードで開きます — サインインして「Approve」をクリックするだけです。認証情報は~/.config/yaku/.credentialsに保存されます。

yaku login
# ブラウザが開いて認証を完了

yaku logout

サーバー上のセッションを無効化し、ローカルの認証情報を削除します。サーバーに到達できない場合、認証情報はリトライ用に保持されます。

yaku logout

# サーバーの無効化が失敗してもローカルの認証情報を強制削除
yaku logout --force

オプション	説明
--force	サーバーが無効化を確認したかどうかに関わらず、ローカルの認証情報を削除。セッションは期限切れまでサーバー上で有効なままになる可能性があります。

yaku whoami

ホステッドサービスに問い合わせて現在の認証状態を表示します。

yaku whoami
# Logged in as Jane Doe ([email protected], github)

未ログインの場合：

Not logged in (using anonymous quota)

セッションが期限切れまたは無効の場合：

Session expired or invalid. Run yaku login to re-authenticate.

サーバーに到達できない場合：

hosted service unreachable. Check your network connection

yaku quota

ホステッドサービスの現在の使用量クォータを表示します。プランの種類、日次・月次リクエスト数、リクエストあたりの文字数制限を表示します。ローカルバックエンド使用時は、クォータが適用されないことを報告します。

詳しくはホステッドサービスとプランをご覧ください。

yaku version

CLIのバージョンを表示します。

yaku version
# yaku v0.1.0