gleef translate
command (also available as gleef push
) sends your translation keys to Gleef for AI-powered translation and makes them available to your team for review.
Usage
Options
Flag | Short | Description |
---|---|---|
--match | -m | Filter translations by key pattern |
--skip-review | -s | Publish translations immediately instead of creating drafts |
What it does
Thetranslate
command:
- Analyzes local files - Compares your local translations with remote state
- Detects changes - Identifies new keys and modified translations
- Handles conflicts - Checks for conflicts with remote edits
- Sends for translation - Uploads keys to Gleef’s AI translation service
- Updates local files - Merges generated translations back to your files
- Creates drafts - Sets up translations for team review (unless
--skip-review
is used)
Basic Usage
Push All Changes
Filter by Pattern
Skip Review Process
Example Output
Processing New Translations
Processing Mixed Changes
No Changes to Process
Pattern Matching
The--match
flag supports flexible pattern matching:
Wildcard Patterns
Complex Patterns
Conflict Resolution
If there are conflicts with remotely edited translations, the command will stop and show details:Resolving Conflicts
- Update locally - Change your local value to match the remote
- Update remotely - Change the value in Gleef Studio
- Pull first - Run
gleef pull
to get latest changes, then translate
Translation Process
New Keys
When you add new translation keys:translate
command will:
- Detect the new keys
- Send them to Gleef AI for translation
- Generate translations in all your target languages
- Update your local files with the generated translations
Modified Keys
When you change existing translations:- Detect the modification
- Push the edited translation as draft or directly publish it
- Preserve translations in other languages
Review Workflow
Default Behavior (Draft Mode)
By default, translations are created as drafts for team review:- Translations generated - AI creates translations for all target languages
- Drafts created - Translations are marked as drafts in Gleef Studio, where you can ask for a review
- Team reviews - Your team can review and approve in Gleef Studio
- Pull approved - Use
gleef pull
to sync approved translations
Skip Review Mode
With--skip-review
, translations are published immediately:
- Automated workflows
- Non-critical translations
- When you trust the AI output completely
Examples
Development Workflow
Feature Development
Bulk Updates
Error Handling
Common Errors
Authentication Error:gleef login
to re-authenticate
Configuration Error:
gleef init
or check your .gleef/config.json
Network Error:
Best Practices
Always pull latest changes before pushing new translations to avoid conflicts.
- Pull latest changes -
gleef pull
to get recent updates - Use patterns for large translation jobs - Filter with
--match
for focused updates - Review in Gleef Studio - Check AI translations quality and ask for a review there or publish
- Coordinate with team - Ensure reviewers know about pending translations