lokalise-install-auth
Install and configure Lokalise SDK/CLI authentication. Use when setting up a new Lokalise integration, configuring API tokens, or initializing Lokalise in your project. Trigger with phrases like "install lokalise", "setup lokalise", "lokalise auth", "configure lokalise API token".
- License 许可
- MIT
- 最近更新
- 2026-05-26
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- lokalise-install-auth
- author
- Jeremy Longshore <jeremy@intentsolutions.io>
- license
- MIT
- version
- 1.0.0
- description
- Install and configure Lokalise SDK/CLI authentication. Use when setting up a new Lokalise integration, configuring API tokens, or initializing Lokalise in your project. Trigger with phrases like "install lokalise", "setup lokalise", "lokalise auth", "configure lokalise API token".
- allowed-tools
- Read, Write, Edit, Bash(npm:*), Bash(pip:*), Bash(lokalise2:*), Grep
- compatible-with
- claude-code, codex, openclaw
03 SKILL.md 正文
Lokalise Install & Auth
Overview
Set up Lokalise SDK/CLI and configure API token authentication for translation management.
Prerequisites
- Node.js 14+ (v18+ recommended for ESM support)
- Package manager (npm, pnpm, or yarn)
- Lokalise account with project access
- API token from Lokalise profile settings
Instructions
Step 1: Install Node.js SDK
set -euo pipefail
# Node.js SDK (ESM module, v9+)
npm install @lokalise/node-api
# For CommonJS projects, use v8
npm install @lokalise/node-api@8
Step 2: Install CLI Tool (Optional)
# macOS via Homebrew
brew tap lokalise/cli-2
brew install lokalise2
# Linux/Windows via direct download
# Visit: https://github.com/lokalise/lokalise-cli-2-go/releases
# Verify installation
lokalise2 --version
Step 3: Generate API Token
- Log into Lokalise
- Click profile avatar -> Profile Settings
- Go to "API tokens" tab
- Click "Generate new token"
- Choose "Read and write" for full access
- Copy the token immediately (shown only once)
Step 4: Configure Authentication
# Set environment variable
export LOKALISE_API_TOKEN="your-api-token"
# Or create .env file
echo 'LOKALISE_API_TOKEN=your-api-token' >> .env
# CLI configuration (creates ~/.lokalise2/config.yml)
lokalise2 --token "$LOKALISE_API_TOKEN" project list
Step 5: Verify Connection
import { LokaliseApi } from "@lokalise/node-api";
const lokaliseApi = new LokaliseApi({
apiKey: process.env.LOKALISE_API_TOKEN!,
});
// Test connection by listing projects
const projects = await lokaliseApi.projects().list();
console.log(`Connected! Found ${projects.items.length} projects.`);
Output
- Installed
@lokalise/node-apipackage - Optional:
lokalise2CLI installed - Environment variable or .env file with API token
- Successful connection verification
Error Handling
| Error | Cause | Solution |
|---|---|---|
401 Unauthorized |
Invalid or expired token | Generate new token in profile settings |
403 Forbidden |
Token lacks required permissions | Use read-write token, not read-only |
ERR_REQUIRE_ESM |
Using require() with SDK v9+ | Use ESM imports or downgrade to v8 |
ENOTFOUND api.lokalise.com |
Network blocked | Check firewall allows outbound HTTPS |
Examples
TypeScript Setup (ESM)
import { LokaliseApi } from "@lokalise/node-api";
const lokaliseApi = new LokaliseApi({
apiKey: process.env.LOKALISE_API_TOKEN!,
});
// List all projects
const projects = await lokaliseApi.projects().list();
projects.items.forEach(p => console.log(`${p.project_id}: ${p.name}`));
CommonJS Setup (SDK v8)
const { LokaliseApi } = require("@lokalise/node-api");
const lokaliseApi = new LokaliseApi({
apiKey: process.env.LOKALISE_API_TOKEN,
});
lokaliseApi.projects().list().then(projects => {
console.log(`Found ${projects.items.length} projects`);
});
CLI Configuration File
# ~/.lokalise2/config.yml
token: "your-api-token"
project_id: "123456789.abcdef"
OAuth2 Authentication (for apps)
import { LokaliseApiOAuth } from "@lokalise/node-api";
// Use token obtained via OAuth2 flow
const lokaliseApi = new LokaliseApiOAuth({
apiKey: oauthAccessToken,
});
Resources
Next Steps
After successful auth, proceed to lokalise-hello-world for your first API call.
04 同仓库更多 Skills
zustand-store-ts
Create Zustand stores with TypeScript, subscribeWithSelector middleware, and proper state/action separation. Use when building React state management, creating global stores, or implementing reactive state patterns with Zustand.
zustand-store-creator
Zustand Store Creator - Auto-activating skill for Frontend Development. Triggers on: zustand store creator, zustand store creator Part of the Frontend Development skill category.
zero-trust-config-helper
Zero Trust Config Helper - Auto-activating skill for Security Advanced. Triggers on: zero trust config helper, zero trust config helper Part of the Security Advanced skill category.
zapier-integration-helper
Zapier Integration Helper - Auto-activating skill for Business Automation. Triggers on: zapier integration helper, zapier integration helper Part of the Business Automation skill category.
zai-cli
Execute z.AI CLI providing vision, search, reader, and GitHub exploration via CLI and MCP. Use when user needs image/video analysis, OCR, UI-to-code conversion, error diagnosis, real-time web search, web page to markdown extraction, or GitHub code exploration. Trigger with phrases like "analyze this image", "search the web for", "read this page", "explore this repo", or "use zai". Requires Z_AI_API_KEY.
yt-research
Research competitor YouTube channels, niches, and trending topics for your content strategy. Use this skill whenever the user says "research channels", "analyze competitors", "find trending topics", "niche analysis", "competitive research", "what are other creators doing", "scrape YouTube channels", or wants to understand the competitive landscape for a specific tool or topic area. Use when working with yt research. Trigger with 'yt', 'research'.