Agent skill · software engineering · jeremylongshore
lokalise-install-auth
Install and configure Lokalise SDK/CLI authentication.
Why this skill is useful
Adds installation scripts and configuration steps for the Lokalise SDK and CLI, enabling seamless integration with translation management workflows.
What it needs
Requires lokalise2, node installed locally. Requires lokalise account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Lokalise Install & Auth Overview Set up Lokalise SDK/CLI and configure API token authentication for translation management. Covers the Node.js SDK (@lokalise/node-api v12+), the CLI (lokalise2), and OAuth2 for Lokalise apps. Prerequisites Node.js 18+ (SDK v9+ is ESM-only) Package manager (npm, pnpm, or yarn) Lokalise account with project access API token from Lokalise profile settings Instructions Step 1: Install Node.js SDK Step 2: Install CLI Tool Step 3: Generate API Token 1. Log into Lokalise 2. Click profile avatar > Profile Settings 3. Go to API tokens tab 4. Click Generate new token 5. Choose Read and write for full access (or Read only for CI download pipelines) 6. Copy the token immediately (shown only once) Step 4: Configure Authentication Step 5: Verify Connection Step 6: OAuth2 Authentication (for Lokalise Apps) OAuth2 is required when building Lokalise marketplace apps that act on behalf of users. Standard API tokens are sufficient for internal integrations. Output Installed @lokalise/node-api package (ESM v9+ or CJS v8) lokalise2 CLI installed and verified Environment variable or .env file with API token Successful connection verification listing accessible projects Error Handling Error Cause Solution ------- ------- ---------- 401 Unauthorized Invalid or expired token Generate new token at Profile Settings > API Tokens 403 Forbidden Token lacks required scope Use read-write token, or check OAuth scopes ERRREQUIREESM Using require() with SDK v9+ Use ESM import or downgrade to @lokalise/node-api@8 ENOTFOUND api.lokalise.com Network blocked Check firewall allows outbound HTTPS to api.lokalise.com Cannot find module SDK not installed Run npm install @lokalise/node-api Examples TypeScript ESM Setup CLI Configuration File Verify Token Permissions (curl) Resources Lokalise Developer Hub API Authentication Node SDK Documentation CLI v2 Documentation OAuth2 Guide Next Steps After successful auth, proceed to lokalise-hello-world for your first API call.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/lokalise-install-auth