docs: add langcodec config example

Author: WendellXY

README.md

@@ -105,6 +105,23 @@ This is a `0.9.1` release available on [crates.io](https://crates.io/crates/lang
 - Strict status filtering note: `langcodec --strict view --status ...` requires explicit status metadata (supported in v1: `.xcstrings`).
 - Translate defaults to `new,stale`, writes `needs_review`, skips plurals, and supports `langcodec.toml` for translate-specific defaults.
 
+#### Example `langcodec.toml`
+
+Save this as `langcodec.toml` in your project root, or point to it with `--config`.
+The CLI discovers `langcodec.toml` by searching the current directory and then parent directories.
+
+```toml
+[translate]
+provider = "openai"
+model = "gpt-4.1-mini"
+source_lang = "en"
+target_lang = "fr"
+concurrency = 4
+status = ["new", "stale"]
+```
+
+There is also a commented example file at `langcodec.toml.example` in the repository root.
+
 #### Plurals
 
 - Android `<plurals>` are fully supported. They convert to the internal `Translation::Plural` representation and back to `<plurals>` with quantities `zero/one/two/few/many/other`.

langcodec-cli/README.md

@@ -109,6 +109,24 @@ Behavior:
 - writes in-place by default and supports `--dry-run`
 - supports translate defaults from `langcodec.toml`
 
+Example `langcodec.toml`:
+
+```toml
+[translate]
+provider = "openai"
+model = "gpt-4.1-mini"
+source_lang = "en"
+target_lang = "fr"
+concurrency = 4
+status = ["new", "stale"]
+```
+
+Config notes:
+
+- save the file as `langcodec.toml` in your project root, or pass `--config /absolute/path/to/langcodec.toml`
+- config discovery walks upward from the current directory until it finds `langcodec.toml`
+- CLI flags still override config values
+
 Provider/auth notes:
 
 - choose a Mentra provider with `--provider` (`openai|anthropic|gemini`) or `translate.provider` in config

langcodec.toml.example

@@ -0,0 +1,28 @@
+# Example langcodec.toml
+#
+# langcodec looks for this file in the current directory and then walks up
+# parent directories until it finds one. You can also pass an explicit path:
+#   langcodec translate --config /absolute/path/to/langcodec.toml
+#
+# Today, config file support is used by the `translate` command.
+
+[translate]
+# Required unless you pass --provider.
+# Supported values: openai, anthropic, gemini
+provider = "openai"
+
+# Required unless you pass --model or set MENTRA_MODEL.
+model = "gpt-4.1-mini"
+
+# Optional, but useful when the source contains multiple languages.
+source_lang = "en"
+
+# Required unless you pass --target-lang.
+target_lang = "fr"
+
+# Optional. Defaults to 4.
+concurrency = 4
+
+# Optional. Defaults to ["new", "stale"].
+# Only target entries with one of these statuses will be translated.
+status = ["new", "stale"]