AbdallahAHO
diff --git a/‎.github/workflows/ci-semantic-release.yml‎
Lines changed: 27 additions & 29 deletions b/‎.github/workflows/ci-semantic-release.yml‎
Lines changed: 27 additions & 29 deletions
diff --git a/‎CHANGELOG.md‎
Lines changed: 7 additions & 0 deletions b/‎CHANGELOG.md‎
Lines changed: 7 additions & 0 deletions
diff --git a/‎README.md‎
Lines changed: 62 additions & 0 deletions b/‎README.md‎
Lines changed: 62 additions & 0 deletions
diff --git a/‎bin/lokalise-mcp.js‎
Lines changed: 44 additions & 0 deletions b/‎bin/lokalise-mcp.js‎
Lines changed: 44 additions & 0 deletions
diff --git a/‎manifest.json‎
Lines changed: 1 addition & 1 deletion b/‎manifest.json‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎package.json‎
Lines changed: 17 additions & 3 deletions b/‎package.json‎
Lines changed: 17 additions & 3 deletions
diff --git a/‎release/checksums.sha256‎
Lines changed: 1 addition & 1 deletion b/‎release/checksums.sha256‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎release/lokalise-mcp-1.0.5.dxt‎
73.2 MB b/‎release/lokalise-mcp-1.0.5.dxt‎
73.2 MB
diff --git a/‎release/release-summary.json‎
Lines changed: 6 additions & 6 deletions b/‎release/release-summary.json‎
Lines changed: 6 additions & 6 deletions
diff --git a/‎scripts/ensure-executable.js‎
Lines changed: 11 additions & 0 deletions b/‎scripts/ensure-executable.js‎
Lines changed: 11 additions & 0 deletions
@@ -191,38 +191,36 @@ jobs:
                   # Checkout develop
                   git checkout -B develop origin/develop
 
-                  # Try to merge main
-                  if git merge origin/main -m "chore: back-merge main to develop after v${{ steps.get-version.outputs.version }} release" --no-edit; then
-                      echo "✅ Merge successful"
+                  # Try to merge main with strategy to automatically resolve conflicts
+                  # Using -X theirs to always take changes from main when conflicts occur
+                  echo "🔄 Attempting to merge main into develop..."
+                  
+                  if git merge origin/main -X theirs -m "chore: back-merge main to develop after v${{ steps.get-version.outputs.version }} release" --no-edit; then
+                      echo "✅ Merge successful (conflicts auto-resolved using main's version)"
                       # Push to develop
                       git push origin develop
+                      echo "✅ Successfully pushed merged changes to develop"
                   else
-                      echo "⚠️ Merge conflicts detected. Creating a PR for manual resolution."
-
-                      # Create a branch for the back-merge
-                      BACKMERGE_BRANCH="backmerge/v${{ steps.get-version.outputs.version }}-to-develop"
-                      git checkout -b "$BACKMERGE_BRANCH"
-
-                      # Stage any resolved files (in case of partial auto-resolution)
-                      git add -A
-
-                      # Commit with conflicts markers if any
-                      git commit -m "chore: back-merge main to develop after v${{ steps.get-version.outputs.version }} release (with conflicts)" || true
-
-                      # Push the branch
-                      git push origin "$BACKMERGE_BRANCH"
-
-                      # Create a PR for manual resolution
-                      gh pr create \
-                        --title "Back-merge: v${{ steps.get-version.outputs.version }} from main to develop" \
-                        --body "This PR back-merges the changes from the v${{ steps.get-version.outputs.version }} release into develop.
-
-                        ⚠️ **Merge conflicts were detected and need manual resolution.**
-
-                        Please review and resolve any conflicts before merging." \
-                        --base develop \
-                        --head "$BACKMERGE_BRANCH" \
-                        --repo ${{ github.repository }} || echo "PR creation failed, please create manually"
+                      # This should rarely happen with -X theirs, but handle it just in case
+                      echo "⚠️ Unexpected merge failure even with auto-resolution. Attempting force resolution..."
+                      
+                      # Reset to develop and try a different approach
+                      git reset --hard origin/develop
+                      
+                      # Create a temporary branch from main
+                      git checkout -B temp-main origin/main
+                      
+                      # Merge develop into this branch (reverse merge) and take all from main
+                      git merge origin/develop --strategy=ours -m "chore: back-merge main to develop after v${{ steps.get-version.outputs.version }} release (force resolved)"
+                      
+                      # Now force push this as the new develop
+                      git branch -f develop HEAD
+                      git checkout develop
+                      
+                      # Push the resolved develop branch
+                      git push origin develop --force-with-lease
+                      
+                      echo "✅ Force-resolved conflicts by taking all changes from main"
                   fi
 
             # Step 12: Summary
 
@@ -1,3 +1,9 @@
+## [1.0.5] - 2025-08-12
+
+### Added
+- Improve the NPX setup
+
+
 ## [1.0.4] - 2025-08-11
 
 ### Added
@@ -134,6 +140,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Commander.js for CLI framework
 - ES modules with Node.js >=18.0.0 requirement
 
+[1.0.5]: https://github.com/AbdallahAHO/lokalise-mcp/compare/v1.0.4...v1.0.5
 [1.0.4]: https://github.com/AbdallahAHO/lokalise-mcp/compare/v1.0.3...v1.0.4
 [1.0.3]: https://github.com/AbdallahAHO/lokalise-mcp/compare/v1.0.2...v1.0.3
 [1.0.2]: https://github.com/AbdallahAHO/lokalise-mcp/compare/v1.0.1...v1.0.2
 
@@ -138,8 +138,70 @@ Notes:
 - Uses the `/mcp` HTTP endpoint internally and stdio as appropriate
 - Updates by installing a newer `.dxt` from Releases
 
+### Option 3: NPM Global Install
+
+Install globally for persistent access:
+
+```bash
+npx -y @smithery/cli@latest inspect @AbdallahAHO/lokalise-mcp
+```
+
+### Option 2: Claude Desktop Extension (DXT)
+
+Fast, local install for Claude Desktop using a packaged extension.
+
+1) Download the latest `.dxt` from Releases:
+   - https://github.com/AbdallahAHO/lokalise-mcp/releases
+
+2) Install in Claude Desktop:
+   - Double‑click the `.dxt` file, or
+   - Drag it into Claude Desktop → Settings → Extensions
+
+3) When prompted, enter your `LOKALISE_API_KEY` (stored securely in the OS keychain). No Node.js needed; Claude ships the runtime.
+
+4) Verify: ask “Can you list my Lokalise projects?”
+
+Notes:
+- Uses the `/mcp` HTTP endpoint internally and stdio as appropriate
+- Updates by installing a newer `.dxt` from Releases
+
 ### Option 3: Local (clone + run)
 
+# Run the server
+lokalise-mcp
+```
+
+### Option 4: NPX (Quick Start)
+
+Use npx to run the server without installation:
+
+```bash
+# Run directly with npx
+npx lokalise-mcp
+
+# Or configure in Claude Desktop's config file:
+```
+
+**Claude Desktop Configuration** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "lokalise": {
+      "command": "npx",
+      "args": ["-y", "lokalise-mcp"],
+      "env": {
+        "LOKALISE_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+This will automatically download and run the latest version when Claude Desktop starts.
+
+### Option 4: Local (clone + run)
+
 Use this for development or when you prefer to run locally:
 
 ```bash
 
@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+/**
+ * Lokalise MCP Server CLI Wrapper
+ *
+ * This wrapper ensures the MCP server runs correctly whether installed
+ * globally, locally, or via npx.
+ */
+
+import { spawn } from "child_process";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Path to the actual compiled entry point
+const entryPoint = join(__dirname, "..", "dist", "index.js");
+
+// Pass through all arguments and environment variables
+const args = process.argv.slice(2);
+const env = { ...process.env };
+
+// Ensure MCP_SERVER_MODE is set if no arguments (server mode)
+if (args.length === 0 && !env.MCP_SERVER_MODE) {
+	env.MCP_SERVER_MODE = "true";
+}
+
+// Spawn the actual process
+const child = spawn(process.execPath, [entryPoint, ...args], {
+	env,
+	stdio: "inherit",
+});
+
+// Forward the exit code
+child.on("exit", (code) => {
+	process.exit(code || 0);
+});
+
+// Handle errors
+child.on("error", (err) => {
+	console.error("Failed to start Lokalise MCP Server:", err);
+	process.exit(1);
+});
@@ -2,7 +2,7 @@
 	"dxt_version": "0.1",
 	"name": "lokalise-mcp",
 	"display_name": "Lokalise MCP",
-	"version": "1.0.4",
+	"version": "1.0.5",
 	"description": "Unofficial Lokalise integration for AI assistants - manage projects, keys, languages, tasks, translations, teams, and workflows through natural language with 59 intelligent tools across 11 domains.",
 	"long_description": "# Lokalise MCP Server\n\n> **Disclaimer**: This is an independent project and not affiliated with Lokalise Inc. It uses the publicly available Lokalise Node.js SDK to provide MCP integration.\n\n## Transform Your Localization Workflow with Conversational AI\n\n**Stop clicking, start commanding.** With 59 intelligent tools across 9 domains, this MCP server transforms Lokalise from a complex UI into your personal localization assistant. Simply describe what you need in natural language, and watch as your AI orchestrates sophisticated API workflows in seconds.\n\nInstead of clicking through multiple screens, just chat with your AI assistant:\n- *\"Show me all projects with less than 80% translation progress\"*\n- *\"Create a new mobile app project with German, French, and Spanish support\"*\n- *\"Find all untranslated keys in the iOS app and assign them to the German team\"*\n- *\"Archive all keys tagged 'v1_deprecated' across all projects\"*\n\n### 59 Production-Ready Tools Across 9 Domains\n\n**Contributors (5 tools)** - Team collaboration and permission management\n**Keys (5 tools)** - Intelligent key management with bulk operations and smart filtering\n**Glossary (5 tools)** - Terminology consistency and brand voice enforcement\n**Project (5 tools)** - Comprehensive project management capabilities\n**Tasks (5 tools)** - Workflow automation and deadline management\n**Group (4 tools)** - Comprehensive group management capabilities\n**Projects (4 tools)** - Complete project lifecycle management from creation to archival\n**Translations (4 tools)** - Direct translation management with review workflows\n\n### Real-World Workflows That Save Hours\n\n**For Localization Managers:**\n- *Morning standup in 10 seconds*: \"Give me the health check for all active projects. Who's behind schedule?\"\n- *Instant team scaling*: \"Add marie@company.com as a French reviewer to all e-commerce projects\"\n- *Proactive monitoring*: \"Alert me when any project drops below 70% completion\"\n\n**For Developers:**\n- *Zero-friction deployment*: \"Sync the feature/new-login branch to Lokalise and create tasks for Spanish and German\"\n- *Instant validation*: \"Check if all keys in the Android app have iOS equivalents\"\n- *Automated QA*: \"Find all keys with unbalanced brackets and create a cleanup task\"\n\n**For Marketing Teams:**\n- *Campaign launch in one command*: \"Create a project from this Google Doc, translate to our tier-1 markets, use informal tone\"\n- *Brand consistency*: \"Add 'QuantumLeap' to the glossary as non-translatable across all projects\"\n- *Content updates*: \"Update all homepage headlines with the new tagline across all languages\"\n\n**Traditional UI Workflow:**\n- Navigate through multiple screens\n- Click through complex forms\n- Context switch between tools\n- Time: 10-15 minutes per task\n\n**Conversational MCP Workflow:**\n- Express intent in natural language\n- AI orchestrates API calls\n- Results delivered instantly\n- Time: 10-30 seconds per task\n\n\n### Get Started in 30 Seconds\n\n1. Install the MCP server\n2. Add your Lokalise API token\n3. Start commanding your localization workflow\n",
 	"author": {
 
@@ -1,15 +1,19 @@
 {
 	"name": "lokalise-mcp",
-	"version": "1.0.4",
+	"version": "1.0.5",
 	"description": "The Lokalise MCP Server brings Lokalise's localization power to Claude and AI assistants—manage projects, keys, and translations by chat.",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/AbdallahAHO/lokalise-mcp.git"
 	},
+	"bugs": {
+		"url": "https://github.com/AbdallahAHO/lokalise-mcp/issues"
+	},
+	"homepage": "https://github.com/AbdallahAHO/lokalise-mcp#readme",
 	"bin": {
-		"lokalise-mcp": "dist/index.js"
+		"lokalise-mcp": "bin/lokalise-mcp.js"
 	},
 	"type": "module",
 	"module": "dist/index.js",
@@ -29,8 +33,9 @@
 		"mcp:inspect": "dotenv npm run build && dotenv -- npx @modelcontextprotocol/inspector -e TRANSPORT_MODE=stdio -e DEBUG=true node dist/index.js",
 		"mcp:inspect:http": "dotenv npm run build && (dotenv -e TRANSPORT_MODE=http -- node dist/index.js &) && sleep 3 && dotenv -- npx @modelcontextprotocol/inspector http://localhost:3000/mcp",
 		"mcp:stdio": "dotenv npm run build && dotenv -e TRANSPORT_MODE=stdio -- node dist/index.js",
-		"postinstall": "node scripts/ensure-executable.js",
+		"postinstall": "node scripts/ensure-executable.js 2>/dev/null || true",
 		"prepare": "husky",
+		"prepublishOnly": "npm run clean && npm run build",
 		"release:checksums": "node scripts/generate-checksums.js",
 		"release:dry-run": "npm run build && npm run release:prepare && echo '✅ Dry run completed successfully'",
 		"release:prepare": "node scripts/prepare-release.js",
@@ -111,6 +116,15 @@
 		"registry": "https://registry.npmjs.org/",
 		"access": "public"
 	},
+	"files": [
+		"dist/**/*",
+		"bin/**/*",
+		"scripts/ensure-executable.js",
+		"manifest.json",
+		"README.md",
+		"LICENSE",
+		"CHANGELOG.md"
+	],
 	"lint-staged": {
 		"*.{js,ts,json}": [
 			"biome format --write",
 
@@ -1 +1 @@
-675f7acb22801672679d273a67d94704ecc360059547b7ddbfad5eea1e772a70  lokalise-mcp-1.0.4.dxt
+c6c87d16f754fcd0be625a87228a7228d09ea16792676b27679a1b5687b23e30  lokalise-mcp-1.0.5.dxt
@@ -1,19 +1,19 @@
 {
-	"version": "1.0.4",
-	"date": "2025-08-11T15:38:51.889Z",
+	"version": "1.0.5",
+	"date": "2025-08-12T09:17:25.228Z",
 	"assets": [
 		{
-			"filename": "lokalise-mcp-1.0.4.dxt",
-			"sha256": "675f7acb22801672679d273a67d94704ecc360059547b7ddbfad5eea1e772a70"
+			"filename": "lokalise-mcp-1.0.5.dxt",
+			"sha256": "c6c87d16f754fcd0be625a87228a7228d09ea16792676b27679a1b5687b23e30"
 		}
 	],
 	"npm": {
 		"package": "lokalise-mcp",
-		"version": "1.0.4",
+		"version": "1.0.5",
 		"registry": "https://registry.npmjs.org/"
 	},
 	"github": {
 		"repository": "AbdallahAHO/lokalise-mcp",
-		"tag": "v1.0.4"
+		"tag": "v1.0.5"
 	}
 }
@@ -7,9 +7,20 @@ import { fileURLToPath } from "node:url";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const rootDir = path.resolve(__dirname, "..");
+const binScript = path.join(rootDir, "bin", "lokalise-mcp.js");
 const entryPoint = path.join(rootDir, "dist", "index.js");
 
 try {
+	// Make the bin script executable
+	if (fs.existsSync(binScript)) {
+		try {
+			fs.chmodSync(binScript, 0o755);
+		} catch (err) {
+			// Silently fail if chmod is not available (Windows, some containers)
+		}
+	}
+
+	// Also make the dist entry point executable if it exists
 	if (fs.existsSync(entryPoint)) {
 		// Ensure the file is executable (cross-platform)
 		const currentMode = fs.statSync(entryPoint).mode;
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-675f7acb22801672679d273a67d94704ecc360059547b7ddbfad5eea1e772a70 lokalise-mcp-1.0.4.dxt`
	`1`	`+c6c87d16f754fcd0be625a87228a7228d09ea16792676b27679a1b5687b23e30 lokalise-mcp-1.0.5.dxt`
Original file line number	Diff line number	Diff line change
`@@ -1,19 +1,19 @@`
`1`	`1`	`{`
`2`		`- "version": "1.0.4",`
`3`		`- "date": "2025-08-11T15:38:51.889Z",`
	`2`	`+ "version": "1.0.5",`
	`3`	`+ "date": "2025-08-12T09:17:25.228Z",`
`4`	`4`	`"assets": [`
`5`	`5`	`{`
`6`		`- "filename": "lokalise-mcp-1.0.4.dxt",`
`7`		`- "sha256": "675f7acb22801672679d273a67d94704ecc360059547b7ddbfad5eea1e772a70"`
	`6`	`+ "filename": "lokalise-mcp-1.0.5.dxt",`
	`7`	`+ "sha256": "c6c87d16f754fcd0be625a87228a7228d09ea16792676b27679a1b5687b23e30"`
`8`	`8`	`}`
`9`	`9`	`],`
`10`	`10`	`"npm": {`
`11`	`11`	`"package": "lokalise-mcp",`
`12`		`- "version": "1.0.4",`
	`12`	`+ "version": "1.0.5",`
`13`	`13`	`"registry": "https://registry.npmjs.org/"`
`14`	`14`	`},`
`15`	`15`	`"github": {`
`16`	`16`	`"repository": "AbdallahAHO/lokalise-mcp",`
`17`		`- "tag": "v1.0.4"`
	`17`	`+ "tag": "v1.0.5"`
`18`	`18`	`}`
`19`	`19`	`}`