docs: clarify show-metadata token details across CLI surfaces

- Specify input and output tokens in flag help text
- Synchronize metadata descriptions across shell completion definitions
- Localize clarified metadata guidance across supported languages
- Record description clarification in incoming changelog entry

README.md

@@ -745,7 +745,7 @@ Application Options:
       --notification-command=       Custom command to run for notifications (overrides built-in notifications)
       --thinking=                   Set reasoning/thinking level (e.g., off, low, medium, high, or numeric
                                     tokens for Anthropic or Google Gemini)
-      --show-metadata               Print metadata to stderr
+      --show-metadata               Print metadata (input/output tokens) to stderr
       --debug=                      Set debug level (0=off, 1=basic, 2=detailed, 3=trace, 4=wire)
 
 Help Options:

cmd/generate_changelog/incoming/2179.txt

@@ -5,3 +5,4 @@
 - Enable filtered file suggestions for supported path options
 - Add Spotify, transcription, metadata, and wire-debug completion options
 - Include Grok among providers supporting web search completion
+- Keep the input/output token detail in the show-metadata description

completions/_fabric

@@ -150,7 +150,7 @@ _fabric() {
     '(--transcribe-file)--transcribe-file[Audio or video file to transcribe]:audio file:_files -g "*.mp3 *.mp4 *.mpeg *.mpga *.m4a *.wav *.webm"' \
     '(--transcribe-model)--transcribe-model[Model to use for transcription (separate from chat model)]:transcribe model:_fabric_transcription_models' \
     '(--split-media-file)--split-media-file[Split audio/video files larger than 25MB using ffmpeg]' \
-    '(--show-metadata)--show-metadata[Print metadata to stderr]' \
+    '(--show-metadata)--show-metadata[Print metadata (input/output tokens) to stderr]' \
     '(--debug)--debug[Set debug level (0=off, 1=basic, 2=detailed, 3=trace, 4=wire)]:debug level:(0 1 2 3 4)' \
     '(--notification)--notification[Send desktop notification when command completes]' \
     '(--notification-command)--notification-command[Custom command to run for notifications]:notification command:' \

completions/fabric.fish

@@ -153,7 +153,7 @@ function __fabric_register_completions
         complete -c $cmd -l disable-responses-api -d "Disable OpenAI Responses API (default: false)"
         complete -c $cmd -l split-media-file -d "Split audio/video files larger than 25MB using ffmpeg"
         complete -c $cmd -l notification -d "Send desktop notification when command completes"
-        complete -c $cmd -l show-metadata -d "Print metadata to stderr"
+        complete -c $cmd -l show-metadata -d "Print metadata (input/output tokens) to stderr"
         complete -c $cmd -s h -l help -d "Show this help message"
 end
 

internal/cli/flags.go

@@ -109,7 +109,7 @@ type Flags struct {
 	Notification                    bool                 `long:"notification" yaml:"notification" description:"Send desktop notification when command completes"`
 	NotificationCommand             string               `long:"notification-command" yaml:"notificationCommand" description:"Custom command to run for notifications (overrides built-in notifications)"`
 	Thinking                        domain.ThinkingLevel `long:"thinking" yaml:"thinking" description:"Set reasoning/thinking level (e.g., off, low, medium, high, or numeric tokens for Anthropic or Google Gemini)"`
-	ShowMetadata                    bool                 `long:"show-metadata" description:"Print metadata to stderr"`
+	ShowMetadata                    bool                 `long:"show-metadata" description:"Print metadata (input/output tokens) to stderr"`
 	Debug                           int                  `long:"debug" description:"Set debug level (0=off, 1=basic, 2=detailed, 3=trace, 4=wire)" default:"0"`
 }
 

internal/i18n/locales/de.json

@@ -492,7 +492,7 @@
   "prefer_playlist_over_video": "Playlist gegenüber Video bevorzugen, wenn beide IDs in der URL vorhanden sind",
   "print_context": "Kontext ausgeben",
   "print_current_version": "Aktuelle Version ausgeben",
-  "print_metadata_to_stderr": "Metadaten auf stderr ausgeben",
+  "print_metadata_to_stderr": "Metadaten (Eingabe-/Ausgabe-Token) auf stderr ausgeben",
   "print_pattern_contents": "Den Inhalt des angegebenen Musters im Terminal ausgeben",
   "print_session": "Sitzung ausgeben",
   "register_new_extension": "Neue Erweiterung aus Konfigurationsdateipfad registrieren",

internal/i18n/locales/en.json

@@ -492,7 +492,7 @@
   "prefer_playlist_over_video": "Prefer playlist over video if both ids are present in the URL",
   "print_context": "Print context",
   "print_current_version": "Print current version",
-  "print_metadata_to_stderr": "Print metadata to stderr",
+  "print_metadata_to_stderr": "Print metadata (input/output tokens) to stderr",
   "print_pattern_contents": "Print the contents of the named pattern to the terminal",
   "print_session": "Print session",
   "register_new_extension": "Register a new extension from config file path",

internal/i18n/locales/es.json

@@ -492,7 +492,7 @@
   "prefer_playlist_over_video": "Preferir lista de reproducción sobre video si ambos ids están presentes en la URL",
   "print_context": "Imprimir contexto",
   "print_current_version": "Imprimir versión actual",
-  "print_metadata_to_stderr": "Imprimir metadatos en stderr",
+  "print_metadata_to_stderr": "Imprimir metadatos (tokens de entrada/salida) en stderr",
   "print_pattern_contents": "Imprimir el contenido del patrón indicado en la terminal",
   "print_session": "Imprimir sesión",
   "register_new_extension": "Registrar una nueva extensión desde la ruta del archivo de configuración",

internal/i18n/locales/fa.json

@@ -492,7 +492,7 @@
   "prefer_playlist_over_video": "اولویت فهرست پخش نسبت به ویدیو اگر هر دو ID در URL موجود باشند",
   "print_context": "چاپ زمینه",
   "print_current_version": "چاپ نسخه فعلی",
-  "print_metadata_to_stderr": "چاپ فراداده در stderr",
+  "print_metadata_to_stderr": "چاپ فراداده (توکن‌های ورودی/خروجی) در stderr",
   "print_pattern_contents": "چاپ محتوای الگوی مشخص‌شده در ترمینال",
   "print_session": "چاپ جلسه",
   "register_new_extension": "ثبت افزونه جدید از مسیر فایل پیکربندی",

internal/i18n/locales/fr.json

@@ -492,7 +492,7 @@
   "prefer_playlist_over_video": "Préférer la liste de lecture à la vidéo si les deux IDs sont présents dans l'URL",
   "print_context": "Afficher le contexte",
   "print_current_version": "Afficher la version actuelle",
-  "print_metadata_to_stderr": "Afficher les métadonnées sur stderr",
+  "print_metadata_to_stderr": "Afficher les métadonnées (jetons d'entrée/sortie) sur stderr",
   "print_pattern_contents": "Afficher le contenu du motif indiqué dans le terminal",
   "print_session": "Afficher la session",
   "register_new_extension": "Enregistrer une nouvelle extension depuis le chemin du fichier de configuration",

internal/i18n/locales/it.json

@@ -492,7 +492,7 @@
   "prefer_playlist_over_video": "Preferisci playlist al video se entrambi gli ID sono presenti nell'URL",
   "print_context": "Stampa contesto",
   "print_current_version": "Stampa versione corrente",
-  "print_metadata_to_stderr": "Stampa i metadati su stderr",
+  "print_metadata_to_stderr": "Stampa i metadati (token di input/output) su stderr",
   "print_pattern_contents": "Stampa il contenuto del pattern indicato nel terminale",
   "print_session": "Stampa sessione",
   "register_new_extension": "Registra una nuova estensione dal percorso del file di configurazione",

internal/i18n/locales/ja.json

@@ -492,7 +492,7 @@
   "prefer_playlist_over_video": "URLに両方のIDが存在する場合、動画よりプレイリストを優先",
   "print_context": "コンテキストを出力",
   "print_current_version": "現在のバージョンを出力",
-  "print_metadata_to_stderr": "メタデータを stderr に出力",
+  "print_metadata_to_stderr": "メタデータ（入力/出力トークン）を stderr に出力",
   "print_pattern_contents": "指定したパターンの内容をターミナルに出力",
   "print_session": "セッションを出力",
   "register_new_extension": "設定ファイルパスから新しい拡張機能を登録",

internal/i18n/locales/pl.json

@@ -492,7 +492,7 @@
   "prefer_playlist_over_video": "Preferuj playlistę nad filmem, jeśli oba identyfikatory są obecne w URL",
   "print_context": "Wydrukuj kontekst",
   "print_current_version": "Wydrukuj bieżącą wersję",
-  "print_metadata_to_stderr": "Wypisz metadane na stderr",
+  "print_metadata_to_stderr": "Wypisz metadane (tokeny wejściowe/wyjściowe) na stderr",
   "print_pattern_contents": "Wypisz zawartość wskazanego wzorca w terminalu",
   "print_session": "Wydrukuj sesję",
   "register_new_extension": "Zarejestruj nowe rozszerzenie z pliku konfiguracyjnego",

internal/i18n/locales/pt-BR.json

@@ -492,7 +492,7 @@
   "prefer_playlist_over_video": "Preferir playlist ao vídeo se ambos os IDs estiverem presentes na URL",
   "print_context": "Imprimir contexto",
   "print_current_version": "Imprimir versão atual",
-  "print_metadata_to_stderr": "Imprimir metadados no stderr",
+  "print_metadata_to_stderr": "Imprimir metadados (tokens de entrada/saída) no stderr",
   "print_pattern_contents": "Imprimir o conteúdo do padrão indicado no terminal",
   "print_session": "Imprimir sessão",
   "register_new_extension": "Registrar uma nova extensão do caminho do arquivo de configuração",

internal/i18n/locales/pt-PT.json

@@ -492,7 +492,7 @@
   "prefer_playlist_over_video": "Preferir playlist ao vídeo se ambos os IDs estiverem presentes na URL",
   "print_context": "Imprimir contexto",
   "print_current_version": "Imprimir versão atual",
-  "print_metadata_to_stderr": "Imprimir metadados no stderr",
+  "print_metadata_to_stderr": "Imprimir metadados (tokens de entrada/saída) no stderr",
   "print_pattern_contents": "Imprimir o conteúdo do padrão indicado no terminal",
   "print_session": "Imprimir sessão",
   "register_new_extension": "Registar uma nova extensão do caminho do ficheiro de configuração",

internal/i18n/locales/zh.json

@@ -492,7 +492,7 @@
   "prefer_playlist_over_video": "如果 URL 中同时存在两个 ID，则优先选择播放列表而不是视频",
   "print_context": "打印上下文",
   "print_current_version": "打印当前版本",
-  "print_metadata_to_stderr": "将元数据打印到 stderr",
+  "print_metadata_to_stderr": "将元数据（输入/输出令牌）打印到 stderr",
   "print_pattern_contents": "将指定模式的内容打印到终端",
   "print_session": "打印会话",
   "register_new_extension": "从配置文件路径注册新扩展",