cli-lsp-client 1.6.0 → 1.7.0

package/README.md

@@ -10,6 +10,7 @@ CLI tool for getting LSP diagnostics. Uses a background daemon to keep LSP serve
 - Built in Claude Code hook to provide feedback on file edit tool calls
 - Comprehensive daemon management (`list`, `stop-all` commands)
 - Multi-project support with isolated daemon instances per directory
+- [Custom language server support via config files](#custom-language-servers-config-file)
 
 ## Supported Languages
 
@@ -24,6 +25,7 @@ CLI tool for getting LSP diagnostics. Uses a background daemon to keep LSP serve
 | GraphQL               | `graphql-language-service-cli` | ✓ (via bunx)                         | `.graphql`, `.gql`                                                                                                                           |
 | **R**                 | **R languageserver**           | **✗**                                | **`.r`, `.R`, `.rmd`, `.Rmd` - see [R Installation](#r-installation-guide) below**                                                           |
 | **C#**                | **OmniSharp-Roslyn**           | **✗**                                | **`.cs` - see [C# Installation](#c-installation-guide) below**                                                                               |
+| **Swift**             | **SourceKit-LSP**              | **✗**                                | **`.swift` - see [Swift Configuration](#swift-configuration) below**                                                                         |
 | Go                    | `gopls`                        | ✗                                    | Requires manual install: `go install golang.org/x/tools/gopls@latest`                                                                        |
 | Java                  | `jdtls` (Eclipse JDT)          | ✗                                    | `.java` - see [Java Installation](#java-installation-guide) below                                                                            |
 | Lua                   | `lua-language-server`          | ✗                                    | `.lua` - requires manual install via package manager (brew, scoop) or from [releases](https://github.com/LuaLS/lua-language-server/releases) |
@@ -39,7 +41,7 @@ CLI tool for getting LSP diagnostics. Uses a background daemon to keep LSP serve
 
 ### Real-time Diagnostics Hook
 
-Get instant diagnostic feedback for TypeScript, Python, JSON, CSS, YAML, Bash, GraphQL, R, C#, Go, Java, and Lua files as you edit in Claude Code.
+Get instant diagnostic feedback for TypeScript, Python, JSON, CSS, YAML, Bash, GraphQL, R, C#, Swift, Go, Java, and Lua files as you edit in Claude Code.
 
 #### Setup
 
@@ -97,6 +99,72 @@ ERROR at line 3, column 9:
   Code: 2322
 ```
 
+## Custom Language Servers (Config File)
+
+You can extend the built-in language servers by creating a custom configuration file. This allows you to add support for any LSP server not included by default.
+
+### Configuration File
+
+Create a config file at `~/.config/cli-lsp-client/settings.json` (default location) or use `--config-file` to specify a custom path:
+
+```json
+{
+  "servers": [
+    {
+      "id": "svelte",
+      "extensions": [".svelte"],
+      "rootPatterns": ["svelte.config.js", "package.json"],
+      "command": ["bunx", "svelte-language-server", "--stdio"],
+      "env": {
+        "NODE_ENV": "development"
+      },
+      "initialization": {
+        "settings": {
+          "svelte": {
+            "compilerWarnings": true
+          }
+        }
+      }
+    }
+  ],
+  "languageExtensions": {
+    ".svelte": "svelte"
+  }
+}
+```
+
+### Using Custom Config
+
+**Default config file location:**
+
+```bash
+# Uses ~/.config/cli-lsp-client/settings.json automatically
+npx cli-lsp-client diagnostics Component.svelte
+```
+
+**Custom config file location:**
+
+```bash
+# Specify custom config file path
+npx cli-lsp-client --config-file ./my-config.json diagnostics Component.svelte
+npx cli-lsp-client --config-file ./my-config.json hover Component.svelte myFunction
+npx cli-lsp-client --config-file ./my-config.json status
+```
+
+**Important:** When using `--config-file`, you must include it on every command. The CLI automatically restarts the daemon when switching between different config files to ensure the correct language servers are loaded.
+
+### Config File Schema
+
+- `servers`: Array of custom language server definitions
+  - `id`: Unique identifier for the server
+  - `extensions`: File extensions this server handles (e.g. `[".svelte"]`)
+  - `rootPatterns`: Files/patterns used to detect project root (e.g. `["package.json"]`)
+  - `command`: Command array to start the LSP server (e.g. `["bunx", "svelte-language-server", "--stdio"]`)
+  - `env`: Optional environment variables for the server process
+  - `initialization`: Optional LSP initialization parameters
+
+- `languageExtensions`: Maps file extensions to LSP language identifiers
+
 ## Usage
 
 ### Get Diagnostics
@@ -110,6 +178,9 @@ npx cli-lsp-client diagnostics app.py
 npx cli-lsp-client diagnostics main.go
 npx cli-lsp-client diagnostics analysis.R
 npx cli-lsp-client diagnostics Program.cs
+
+# Check Swift files (requires config file)
+npx cli-lsp-client diagnostics Sources/App/main.swift
 ```
 
 Exit codes: 0 for no issues, 2 for issues found.
@@ -132,6 +203,9 @@ npx cli-lsp-client hover src/main.ts myFunction
 npx cli-lsp-client hover app.py MyClass
 npx cli-lsp-client hover analysis.R mean
 npx cli-lsp-client hover Program.cs Console
+
+# Get hover info for Swift symbols (requires config file)
+npx cli-lsp-client hover Sources/App/main.swift greetUser
 ```
 
 ````bash
@@ -255,11 +329,13 @@ The R language server requires R runtime and the `languageserver` package:
 1. **Install R**: Download and install R from [CRAN](https://cran.r-project.org/) or use a package manager:
 
    **macOS (Homebrew)**:
+
    ```bash
    brew install r
    ```
 
    **Ubuntu/Debian**:
+
    ```bash
    sudo apt-get update
    sudo apt-get install r-base
@@ -268,11 +344,13 @@ The R language server requires R runtime and the `languageserver` package:
    **Windows**: Download installer from [CRAN Windows](https://cran.r-project.org/bin/windows/base/)
 
 2. **Install R languageserver package**: Open R and run:
+
    ```r
    install.packages("languageserver")
    ```
 
    Or from command line:
+
    ```bash
    R --slave -e 'install.packages("languageserver", repos="https://cran.rstudio.com/")'
    ```
@@ -280,6 +358,7 @@ The R language server requires R runtime and the `languageserver` package:
 ### Verification
 
 Test that the language server works:
+
 ```bash
 R --slave -e 'languageserver::run()'
 ```
@@ -287,8 +366,9 @@ R --slave -e 'languageserver::run()'
 ### Project Detection
 
 The R LSP automatically detects R projects based on these files:
+
 - `DESCRIPTION` (R packages)
-- `NAMESPACE` (R packages) 
+- `NAMESPACE` (R packages)
 - `.Rproj` (RStudio projects)
 - `renv.lock` (renv dependency management)
 - Any `.r`, `.R`, `.rmd`, `.Rmd` files
@@ -304,11 +384,13 @@ The C# language server requires .NET SDK and OmniSharp-Roslyn:
 1. **Install .NET SDK**: Download .NET 6.0+ from [Microsoft .NET](https://dotnet.microsoft.com/download) or use a package manager:
 
    **macOS (Homebrew)**:
+
    ```bash
    brew install dotnet
    ```
 
    **Ubuntu/Debian**:
+
    ```bash
    # Add Microsoft package repository
    wget https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
@@ -322,11 +404,12 @@ The C# language server requires .NET SDK and OmniSharp-Roslyn:
 2. **Install OmniSharp-Roslyn**: Download the latest release from [OmniSharp releases](https://github.com/OmniSharp/omnisharp-roslyn/releases):
 
    **Automatic script** (recommended):
+
    ```bash
    # Download and extract OmniSharp to ~/.omnisharp/
    mkdir -p ~/.omnisharp
    curl -L https://github.com/OmniSharp/omnisharp-roslyn/releases/latest/download/omnisharp-osx-arm64-net6.0.tar.gz | tar -xz -C ~/.omnisharp/
-   
+
    # Create symlink to make omnisharp available in PATH
    sudo ln -sf ~/.omnisharp/OmniSharp /usr/local/bin/omnisharp
    ```
@@ -339,11 +422,13 @@ The C# language server requires .NET SDK and OmniSharp-Roslyn:
 3. **Set environment variables**:
 
    **Fish shell**:
+
    ```bash
    set -Ux DOTNET_ROOT ~/.dotnet
    ```
 
    **Bash/Zsh**:
+
    ```bash
    echo 'export DOTNET_ROOT=~/.dotnet' >> ~/.bashrc  # or ~/.zshrc
    source ~/.bashrc  # or ~/.zshrc
@@ -354,6 +439,7 @@ The C# language server requires .NET SDK and OmniSharp-Roslyn:
 ### Verification
 
 Test that OmniSharp works:
+
 ```bash
 # Verify DOTNET_ROOT is set
 echo $DOTNET_ROOT
@@ -365,6 +451,7 @@ omnisharp --help
 ### Project Detection
 
 The C# LSP automatically detects C# projects based on these files:
+
 - `*.sln` (Solution files)
 - `*.csproj` (Project files)
 - `project.json` (Legacy project files)
@@ -373,6 +460,48 @@ The C# LSP automatically detects C# projects based on these files:
 
 For more information, see the [OmniSharp documentation](https://github.com/OmniSharp/omnisharp-roslyn).
 
+## Swift Configuration
+
+Swift language support is available through SourceKit-LSP, which is included with Xcode Command Line Tools. Support for swift and other LSPs can be added via a config file.
+
+### Prerequisites
+
+**macOS (with Xcode Command Line Tools)**:
+
+```bash
+# Check if SourceKit-LSP is available
+xcrun --find sourcekit-lsp
+```
+
+**Alternative toolchains**: If using Swift toolchains from swift.org, SourceKit-LSP is included and can be run with:
+
+```bash
+xcrun --toolchain swift sourcekit-lsp
+```
+
+### Configuration
+
+Create a config file at `~/.config/cli-lsp-client/settings.json`:
+
+```json
+{
+  "servers": [
+    {
+      "id": "sourcekit_lsp",
+      "extensions": [".swift"],
+      "rootPatterns": ["Package.swift", ".xcodeproj", ".xcworkspace"],
+      "command": ["xcrun", "sourcekit-lsp"],
+      "env": {}
+    }
+  ],
+  "languageExtensions": {
+    ".swift": "swift"
+  }
+}
+```
+
+For more information about SourceKit-LSP, see the [official documentation](https://github.com/swiftlang/sourcekit-lsp).
+
 ### Additional Commands
 
 ```bash
@@ -382,7 +511,7 @@ npx cli-lsp-client start
 # Start servers for specific directory
 npx cli-lsp-client start /path/to/project
 
-# View daemon logs
+# View daemon log file path
 npx cli-lsp-client logs
 ```
 

package/package.json

@@ -1,36 +1,11 @@
 {
   "name": "cli-lsp-client",
-  "version": "1.6.0",
-  "description": "CLI tool for fast LSP diagnostics with background daemon and multi-project support",
-  "type": "module",
-  "main": "src/cli.ts",
-  "license": "MIT",
-  "bin": {
-    "cli-lsp-client": "cli-lsp-client"
-  },
-  "files": [
-    "cli-lsp-client"
-  ],
+  "version": "1.7.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/eli0shin/cli-lsp-client.git"
   },
-  "homepage": "https://github.com/eli0shin/cli-lsp-client#readme",
-  "bugs": {
-    "url": "https://github.com/eli0shin/cli-lsp-client/issues"
-  },
-  "scripts": {
-    "build": "bun build src/cli.ts --compile --outfile cli-lsp-client",
-    "dev": "bun run src/cli.ts",
-    "typecheck": "bun --bun tsc --noEmit",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "format": "prettier --check .",
-    "format:fix": "prettier --write .",
-    "test": "bun test",
-    "test:watch": "bun test tests/ --watch",
-    "prepublish": "bun test && bun run build"
-  },
+  "main": "src/cli.ts",
   "devDependencies": {
     "@eslint/js": "^9.33.0",
     "@types/bun": "latest",
@@ -43,15 +18,35 @@
     "globals": "^16.3.0",
     "prettier": "3.6.2",
     "typescript": "latest",
-    "typescript-eslint": "^8.39.1"
-  },
-  "peerDependencies": {
-    "typescript": "^5.0.0"
-  },
-  "dependencies": {
-    "pyright": "^1.1.403",
+    "typescript-eslint": "^8.39.1",
     "vscode-jsonrpc": "^8.2.1",
     "vscode-languageserver-types": "^3.17.5",
     "zod": "^4.0.17"
-  }
+  },
+  "bin": {
+    "cli-lsp-client": "cli-lsp-client"
+  },
+  "bugs": {
+    "url": "https://github.com/eli0shin/cli-lsp-client/issues"
+  },
+  "description": "CLI tool supporting claude code hooks for fast LSP diagnostics with background daemon and multi-project support",
+  "files": [
+    "cli-lsp-client"
+  ],
+  "homepage": "https://github.com/eli0shin/cli-lsp-client#readme",
+  "license": "MIT",
+  "scripts": {
+    "build": "bun build src/cli.ts --compile --outfile cli-lsp-client",
+    "dev": "bun run src/cli.ts",
+    "typecheck": "bun tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --check .",
+    "format:fix": "prettier --write .",
+    "test": "bun test",
+    "test:watch": "bun test tests/ --watch",
+    "prepublishOnly": "bun test && bun run build",
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "type": "module"
 }

package/src/cli.ts

@@ -110,10 +110,46 @@ function showHelp(): void {
   process.stdout.write(HELP_MESSAGE + '\n');
 }
 
+type ParsedArgs = {
+  command: string;
+  commandArgs: string[];
+  configFile?: string;
+};
+
+function parseArgs(args: string[]): ParsedArgs {
+  let configFile: string | undefined;
+  const filteredArgs: string[] = [];
+  
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    
+    if (arg === '--config-file') {
+      if (i + 1 >= args.length) {
+        process.stderr.write('Error: --config-file requires a path argument\n');
+        process.exit(1);
+      }
+      configFile = args[i + 1];
+      i++; // Skip the next argument since it's the config file path
+    } else if (arg.startsWith('--config-file=')) {
+      configFile = arg.split('=', 2)[1];
+      if (!configFile) {
+        process.stderr.write('Error: --config-file= requires a path after the equals sign\n');
+        process.exit(1);
+      }
+    } else {
+      filteredArgs.push(arg);
+    }
+  }
+  
+  const command = filteredArgs[0] || 'status';
+  const commandArgs = filteredArgs.slice(1);
+  
+  return { command, commandArgs, configFile };
+}
+
 async function run(): Promise<void> {
-  const args = process.argv.slice(2);
-  const command = args[0] || 'status';
-  const commandArgs = args.slice(1);
+  const rawArgs = process.argv.slice(2);
+  const { command, commandArgs, configFile } = parseArgs(rawArgs);
 
   // Check if we're being invoked to run as daemon
   if (process.env.LSPCLI_DAEMON_MODE === '1') {
@@ -183,7 +219,7 @@ async function run(): Promise<void> {
   }
 
   // All other user commands are handled by the client (which auto-starts daemon if needed)
-  await runCommand(command, commandArgs);
+  await runCommand(command, commandArgs, configFile);
 }
 
 export { run };