Analyze, plan, and execute Lokalise SDK upgrades with breaking change detection. Use when upgrading Lokalise SDK versions, detecting deprecations, or migrating to new API versions. Trigger with phrases like "upgrade lokalise", "lokalise migration", "lokalise breaking changes", "update lokalise SDK", "analyze lokalise version".
Guide for upgrading Lokalise SDK versions and handling breaking changes.
Read(${CLAUDE_SKILL_DIR}/references/implementation-guide.md)| SDK Version | Node.js | Key Changes |
|---|---|---|
| 9.x | 18+ |
| Pure ESM, no require() |
| 8.x | 14+ | Last CommonJS support |
| 7.x | 14+ | Cursor pagination |
| 6.x | 12+ | TypeScript improvements |
set -euo pipefail
# If upgrade causes issues, rollback immediately
npm install @lokalise/[email protected] --save-exact
# Revert ESM changes if needed
git checkout HEAD~1 -- tsconfig.json package.json
# Verify rollback
npm test
set -euo pipefail
# macOS
brew upgrade lokalise2
# Linux - download latest release
curl -sL https://github.com/lokalise/lokalise-cli-2-go/releases/latest/download/lokalise2_linux_x86_64.tar.gz | tar xz
# Verify
lokalise2 --version
For CI integration during upgrades, see lokalise-ci-integration.45:["$","$L4e",null,{"content":"$4f","frontMatter":{"name":"lokalise-upgrade-migration","description":"Analyze, plan, and execute Lokalise SDK upgrades with breaking change detection.\nUse when upgrading Lokalise SDK versions, detecting deprecations,\nor migrating to new API versions.\nTrigger with phrases like "upgrade lokalise", "lokalise migration",\n"lokalise breaking changes", "update lokalise SDK", "analyze lokalise version".\n","allowed-tools":"Read, Write, Edit, Bash(npm:), Bash(git:)","version":"1.0.0","license":"MIT","author":"Jeremy Longshore [email protected]","compatible-with":"claude-code, codex, openclaw"}}]