LSP Detection Skill

Detect available language servers and configure codemunch to use them for precise symbol extraction.

Step 1 — Detect project languages

# Identify languages present in the project
find . -maxdepth 4 \( \
  -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.jsx" \
  -o -name "*.py" \
  -o -name "*.go" \
  -o -name "*.rs" \
  -o -name "*.rb" \
  -o -name "*.java" -o -name "*.kt" \
  -o -name "*.cs" \
  -o -name "*.cpp" -o -name "*.c" -o -name "*.h" \
  -o -name "*.php" \
  -o -name "*.swift" \
  -o -name "*.lua" \
  -o -name "*.zig" \
  -o -name "*.ex" -o -name "*.exs" \
  -o -name "*.hs" \
  -o -name "*.ml" -o -name "*.mli" \
\) -not -path "*/node_modules/*" -not -path "*/.git/*" \
  -not -path "*/target/*" -not -path "*/__pycache__/*" \
  2>/dev/null | \
  sed 's/.*\.//' | sort | uniq -c | sort -rn | head -20

Step 2 — Check for installed language servers

For each detected language, check if a server is installed:

# TypeScript / JavaScript
which typescript-language-server 2>/dev/null && echo "LSP:typescript=typescript-language-server --stdio"
which tsserver 2>/dev/null && echo "LSP:typescript-alt=tsserver"
# Check via npx as fallback
npx --yes typescript-language-server --version 2>/dev/null && echo "LSP:typescript-npx=npx typescript-language-server --stdio"

# Python
which pylsp 2>/dev/null && echo "LSP:python=pylsp"
which pyright-langserver 2>/dev/null && echo "LSP:python=pyright-langserver --stdio"
which pyright 2>/dev/null && echo "LSP:python-alt=pyright --stdio"
which jedi-language-server 2>/dev/null && echo "LSP:python-alt2=jedi-language-server"

# Go
which gopls 2>/dev/null && echo "LSP:go=gopls"

# Rust
which rust-analyzer 2>/dev/null && echo "LSP:rust=rust-analyzer"

# Ruby
which solargraph 2>/dev/null && echo "LSP:ruby=solargraph stdio"
which ruby-lsp 2>/dev/null && echo "LSP:ruby-alt=ruby-lsp"

# Java
which jdtls 2>/dev/null && echo "LSP:java=jdtls"
which java-language-server 2>/dev/null && echo "LSP:java-alt=java-language-server"

# Kotlin
which kotlin-language-server 2>/dev/null && echo "LSP:kotlin=kotlin-language-server"

# C / C++
which clangd 2>/dev/null && echo "LSP:c=clangd"
which ccls 2>/dev/null && echo "LSP:c-alt=ccls"

# C#
which omnisharp 2>/dev/null && echo "LSP:csharp=omnisharp -lsp"
which csharp-ls 2>/dev/null && echo "LSP:csharp-alt=csharp-ls"

# PHP
which phpactor 2>/dev/null && echo "LSP:php=phpactor language-server"
which intelephense 2>/dev/null && echo "LSP:php-alt=intelephense --stdio"

# Swift
which sourcekit-lsp 2>/dev/null && echo "LSP:swift=sourcekit-lsp"

# Lua
which lua-language-server 2>/dev/null && echo "LSP:lua=lua-language-server"

# Zig
which zls 2>/dev/null && echo "LSP:zig=zls"

# Elixir
which elixir-ls 2>/dev/null && echo "LSP:elixir=elixir-ls"
which lexical 2>/dev/null && echo "LSP:elixir-alt=lexical"

# Haskell
which haskell-language-server 2>/dev/null && echo "LSP:haskell=haskell-language-server-wrapper --lsp"
which haskell-language-server-wrapper 2>/dev/null && echo "LSP:haskell=haskell-language-server-wrapper --lsp"

# OCaml
which ocamllsp 2>/dev/null && echo "LSP:ocaml=ocamllsp"

# Bash / Shell
which bash-language-server 2>/dev/null && echo "LSP:bash=bash-language-server start"

# YAML
which yaml-language-server 2>/dev/null && echo "LSP:yaml=yaml-language-server --stdio"

# JSON
which vscode-json-language-server 2>/dev/null && echo "LSP:json=vscode-json-language-server --stdio"

# CSS / HTML
which vscode-css-language-server 2>/dev/null && echo "LSP:css=vscode-css-language-server --stdio"
which vscode-html-language-server 2>/dev/null && echo "LSP:html=vscode-html-language-server --stdio"

Step 3 — Check for ctags fallback

which universal-ctags 2>/dev/null && echo "CTAGS=universal-ctags"
which ctags 2>/dev/null && ctags --version 2>&1 | grep -q "Universal" && echo "CTAGS=ctags (universal)"
which ctags 2>/dev/null && echo "CTAGS=ctags (exuberant or basic)"

Step 4 — Check for ripgrep

which rg 2>/dev/null && echo "RG=rg $(rg --version | head -1)"
which grep 2>/dev/null && echo "GREP=grep (fallback)"

Step 5 — Write .claude/codemunch/config.json

Create or update .claude/codemunch/config.json in the project root:

{
  "version": "1.0",
  "engines": {
    "[language]": {
      "primary": "lsp",
      "lsp_cmd": "[detected command]",
      "fallback": "ctags",
      "last_resort": "rg"
    }
  },
  "index_path": ".claude/codemunch/index.json",
  "last_indexed": null,
  "stats": {
    "total_symbols": 0,
    "files_indexed": 0
  }
}

Add one entry per detected language. For languages with no LSP, set primary to ctags or rg directly.

Step 6 — Report to user

✅ codemunch LSP detection complete

Engines configured:
  TypeScript   → typescript-language-server (LSP) ✅
  Python       → pylsp (LSP) ✅
  Go           → gopls (LSP) ✅
  Rust         → rust-analyzer (LSP) ✅

Fallback chain for unlisted languages:
  ctags        → [installed ✅ / not found ⚠️]
  ripgrep      → [installed ✅ / not found ⚠️]

Run /codemunch:index to build the symbol index.

If a language has no LSP and ctags is missing, suggest install commands:

• macOS: brew install universal-ctags ripgrep
• Ubuntu/Debian: apt install universal-ctags ripgrep
• Windows: scoop install ctags ripgrep