Repository navigation
v0.10.0
v0.10.0 expands langcodec from a localization file toolkit into a more complete localization workflow CLI. This release introduces AI-assisted translation and annotation for Apple string catalogs, adds native Tolgee sync workflows, and improves the terminal experience with styled output and interactive dashboards.
Highlights
- Added a new
translatecommand for AI-assisted localization workflows. - Added a new
annotatecommand to generate translator-facing.xcstringscomments from source usage while preserving existing manual comments. - Added
tolgee pullandtolgee pushworkflows for syncing mapped.xcstringscatalogs with Tolgee. - Added TUI dashboards and improved styled terminal output for long-running CLI workflows.
- Reworked
langcodec.tomlsupport to better structure provider, translation, annotation, and Tolgee settings. - Improved the core
.xcstringstranslation workflow and annotation search resilience.
What’s New
translatenow supports Mentra-backed providers, including OpenAI, Anthropic, and Gemini.- Translation runs can target multiple languages in one pass and update multi-language
.xcstringsfiles in place. - Tolgee can be used as a prefill source before AI fallback during translation runs.
annotatecan search project source roots and generate better translator context directly into.xcstrings.langcodec.tomlcan now act as the source of truth for translate, annotate, and Tolgee workflows.- The CLI now supports
--ui auto|plain|tuifor richer progress reporting. - The TUI remains open until you explicitly quit, making it easier to inspect results at the end of a run.
Improvements
- Better terminal styling and clearer output summaries across the CLI.
- More resilient annotation tool search behavior.
- Refreshed documentation in the main README and CLI README.
- Added a
langcodec.example.tomlto help teams adopt config-driven workflows.
Upgrade Notes
- If you use config-driven AI workflows, review your existing
langcodec.tomlagainst the new example config. - If exactly one provider section is configured,
translateandannotatecan now auto-select it. - If multiple providers are configured, explicitly set
--providerortranslate.provider. - Tolgee support in this release is focused on Apple
.xcstringsworkflows.
Full Changelog
feat(cli): add Tolgee sync workflowsfix(cli): keep TUI open until explicit quitfeat(cli): add tui dashboardsfeat(cli): restructure langcodec configfeat(cli): add styled terminal outputfix(cli): improve annotate tool search resiliencefeat(cli): add agent-backed xcstrings annotationfeat(core): improve xcstrings translate workflowAdd Mentra-backed translate commanddocs: refresh project and cli readmesdocs: add langcodec config example
Compare: v0.9.1...v0.10.0