feat(parser): add Elixir language support

- [x] Add Elixir documentation extraction (@doc and @moduledoc attributes)
- [x] Add Elixir symbol extraction (modules, functions, macros, structs, protocols)
- [x] Add tree-sitter Elixir language parser integration
- [x] Add Elixir language detection for .ex and .exs file extensions
- [x] Add Elixir symbol extraction tests
- [x] Update language support table in README
- [x] Improve install script with package manager detection and LSP installation
- [x] Fix shell script portability (replace echo -e with printf)
- [x] Fix checksum verification in install script for macOS/Linux compatibility

.github/workflows/release.yaml

@@ -16,9 +16,8 @@ permissions:
 
 jobs:
   release:
-    uses: lukaszraczylo/shared-actions/.github/workflows/go-release.yaml@main
+    uses: lukaszraczylo/shared-actions/.github/workflows/go-release-cgo.yaml@main
     with:
       go-version: "1.24"
-      docker-enabled: false
       rolling-release-tag: "v1"
     secrets: inherit

.goreleaser.yaml

@@ -15,7 +15,7 @@ builds:
     main: ./cmd/mcp-filepuff
     binary: mcp-filepuff
     env:
-      - CGO_ENABLED=0
+      - CGO_ENABLED=1
     flags:
       - -trimpath
     ldflags:
@@ -30,6 +30,13 @@ builds:
     goarch:
       - amd64
       - arm64
+    ignore:
+      - goos: darwin
+        goarch: amd64
+      - goos: linux
+        goarch: arm64
+      - goos: windows
+        goarch: arm64
 
 archives:
   - id: default
@@ -82,23 +89,6 @@ release:
     curl -sSL https://raw.githubusercontent.com/lukaszraczylo/filepuff-mcp/main/scripts/install.sh | bash
     ```
 
-dockers_v2:
-  - images:
-      - "ghcr.io/lukaszraczylo/filepuff-mcp"
-    tags:
-      - "{{ .Version }}"
-      - "latest"
-      - "v1"
-    platforms:
-      - linux/amd64
-      - linux/arm64
-    dockerfile: Dockerfile.goreleaser
-    labels:
-      "org.opencontainers.image.created": "{{.Date}}"
-      "org.opencontainers.image.title": "{{.ProjectName}}"
-      "org.opencontainers.image.revision": "{{.FullCommit}}"
-      "org.opencontainers.image.version": "{{.Version}}"
-      "org.opencontainers.image.source": "https://github.com/lukaszraczylo/filepuff-mcp"
 
 signs:
   - cmd: cosign
@@ -111,11 +101,4 @@ signs:
     artifacts: checksum
     output: true
 
-docker_signs:
+
-  - cmd: cosign
-    artifacts: manifests
-    output: true
-    args:
-      - sign
-      - "${artifact}@${digest}"
-      - "--yes"

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lukasz Raczylo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -14,33 +14,49 @@ A Go-based MCP (Model Context Protocol) server for Claude Code providing intelli
 
 ## Installation
 
-### Binary Releases (Recommended)
+### Quick Install (Recommended)
+
+Install the latest version with a single command:
+
+```bash
+curl -sSL https://raw.githubusercontent.com/lukaszraczylo/filepuff-mcp/main/scripts/install.sh | bash
+```
+
+This script will:
+- Automatically detect your platform (OS and architecture)
+- Download the latest release
+- Verify checksums
+- Install to `~/.local/bin` (or `/usr/local/bin` if needed)
+- Make the binary executable
+
+### Manual Installation
 
 Download pre-built binaries from the [releases page](https://github.com/lukaszraczylo/filepuff-mcp/releases):
 
 ```bash
 # macOS (ARM64)
-curl -L https://github.com/lukaszraczylo/filepuff-mcp/releases/latest/download/mcp-filepuff-darwin-arm64.tar.gz | tar xz
+curl -L https://github.com/lukaszraczylo/filepuff-mcp/releases/latest/download/mcp-filepuff_<version>_darwin_arm64.tar.gz | tar xz
-sudo mv mcp-filepuff /usr/local/bin/
+mv mcp-filepuff ~/.local/bin/
 
 # macOS (AMD64)
-curl -L https://github.com/lukaszraczylo/filepuff-mcp/releases/latest/download/mcp-filepuff-darwin-amd64.tar.gz | tar xz
+curl -L https://github.com/lukaszraczylo/filepuff-mcp/releases/latest/download/mcp-filepuff_<version>_darwin_amd64.tar.gz | tar xz
-sudo mv mcp-filepuff /usr/local/bin/
+mv mcp-filepuff ~/.local/bin/
 
 # Linux (ARM64)
-curl -L https://github.com/lukaszraczylo/filepuff-mcp/releases/latest/download/mcp-filepuff-linux-arm64.tar.gz | tar xz
+curl -L https://github.com/lukaszraczylo/filepuff-mcp/releases/latest/download/mcp-filepuff_<version>_linux_arm64.tar.gz | tar xz
-sudo mv mcp-filepuff /usr/local/bin/
+mv mcp-filepuff ~/.local/bin/
 
 # Linux (AMD64)
-curl -L https://github.com/lukaszraczylo/filepuff-mcp/releases/latest/download/mcp-filepuff-linux-amd64.tar.gz | tar xz
+curl -L https://github.com/lukaszraczylo/filepuff-mcp/releases/latest/download/mcp-filepuff_<version>_linux_amd64.tar.gz | tar xz
-sudo mv mcp-filepuff /usr/local/bin/
+mv mcp-filepuff ~/.local/bin/
 
 # Windows (PowerShell)
-Invoke-WebRequest -Uri "https://github.com/lukaszraczylo/filepuff-mcp/releases/latest/download/mcp-filepuff-windows-amd64.zip" -OutFile mcp-filepuff.zip
+Invoke-WebRequest -Uri "https://github.com/lukaszraczylo/filepuff-mcp/releases/latest/download/mcp-filepuff_<version>_windows_amd64.zip" -OutFile mcp-filepuff.zip
-Expand-Archive mcp-filepuff.zip -DestinationPath .
+Expand-Archive mcp-filepuff.zip -DestinationPath $env:USERPROFILE\.local\bin
-Move-Item mcp-filepuff.exe C:\Windows\System32\
 ```
 
+Replace `<version>` with the actual version (e.g., `v1.0.0`).
+
 ### Prerequisites
 
 - [ripgrep](https://github.com/BurntSushi/ripgrep) (`rg`) installed and in PATH
@@ -409,6 +425,7 @@ Apply an edit to a file. Uses AST-aware editing for code files with syntax valid
 | HTML | .html, .htm | Yes | Yes | - | Yes |
 | Vue | .vue | Yes | Yes* | - | Yes |
 | React | .jsx, .tsx | Yes | Yes | typescript-language-server | Yes |
+| Elixir | .ex, .exs | Yes | Yes | elixir-ls | Yes |
 
 \* Vue uses HTML parser for template sections
 

internal/parser/docextract.go

@@ -46,6 +46,8 @@ func ExtractDocComment(n *sitter.Node, content []byte, lang protocol.Language) *
 		return extractPythonDocComment(n, content)
 	case protocol.LangC, protocol.LangCpp:
 		return extractCDocComment(n, content)
+	case protocol.LangElixir:
+		return extractElixirDocComment(n, content)
 	default:
 		return nil
 	}
@@ -548,3 +550,109 @@ func cleanPythonDocstring(doc string) string {
 
 	return strings.TrimSpace(doc)
 }
+
+// extractElixirDocComment extracts Elixir documentation from @doc and @moduledoc attributes.
+// Elixir uses module attributes like @doc and @moduledoc for documentation.
+func extractElixirDocComment(n *sitter.Node, content []byte) *DocComment {
+	// Look for @doc or @moduledoc attribute preceding this node
+	prev := n.PrevSibling()
+
+	for prev != nil {
+		// Check if this is an unary_operator with @ (module attribute)
+		if prev.Type() == "unary_operator" {
+			text := GetNodeText(prev, content)
+			trimmed := strings.TrimSpace(text)
+
+			// Check for @doc or @moduledoc
+			if strings.HasPrefix(trimmed, "@doc") || strings.HasPrefix(trimmed, "@moduledoc") {
+				// Extract the documentation string
+				docText := extractElixirDocString(prev, content)
+				if docText != "" {
+					return &DocComment{
+						Text:      docText,
+						Raw:       text,
+						Style:     CommentStyleDocstring,
+						Tags:      nil,
+						StartLine: int(prev.StartPoint().Row) + 1,
+						EndLine:   int(prev.EndPoint().Row) + 1,
+					}
+				}
+			}
+		}
+
+		// Also check for regular # comments
+		if prev.Type() == "comment" {
+			comments := collectPrecedingComments(n, content, []string{"comment"})
+			if len(comments) > 0 {
+				var parts []string
+				var raw []string
+				startLine := -1
+				endLine := -1
+
+				for _, c := range comments {
+					text := GetNodeText(c, content)
+					raw = append(raw, text)
+
+					if startLine == -1 {
+						startLine = int(c.StartPoint().Row) + 1
+					}
+					endLine = int(c.EndPoint().Row) + 1
+
+					// Clean # comment
+					cleaned := strings.TrimSpace(strings.TrimPrefix(strings.TrimSpace(text), "#"))
+					if cleaned != "" {
+						parts = append(parts, cleaned)
+					}
+				}
+
+				if len(parts) > 0 {
+					return &DocComment{
+						Text:      strings.Join(parts, "\n"),
+						Raw:       strings.Join(raw, "\n"),
+						Style:     CommentStyleHash,
+						Tags:      nil,
+						StartLine: startLine,
+						EndLine:   endLine,
+					}
+				}
+			}
+			break
+		}
+
+		prev = prev.PrevSibling()
+	}
+
+	return nil
+}
+
+// extractElixirDocString extracts the documentation string from an Elixir @doc/@moduledoc attribute.
+func extractElixirDocString(n *sitter.Node, content []byte) string {
+	// The doc attribute typically looks like:
+	// @doc """
+	// Documentation here
+	// """
+	// or
+	// @doc "Single line doc"
+
+	text := GetNodeText(n, content)
+
+	// Find the string content after @doc or @moduledoc
+	var docContent string
+
+	// Check for heredoc style (triple quotes)
+	if idx := strings.Index(text, `"""`); idx != -1 {
+		// Find the closing triple quotes
+		rest := text[idx+3:]
+		if endIdx := strings.Index(rest, `"""`); endIdx != -1 {
+			docContent = rest[:endIdx]
+		}
+	} else if idx := strings.Index(text, `"`); idx != -1 {
+		// Single quoted string
+		rest := text[idx+1:]
+		if endIdx := strings.Index(rest, `"`); endIdx != -1 {
+			docContent = rest[:endIdx]
+		}
+	}
+
+	return strings.TrimSpace(docContent)
+}

internal/parser/parser.go

@@ -11,6 +11,7 @@ import (
 	sitter "github.com/smacker/go-tree-sitter"
 	"github.com/smacker/go-tree-sitter/c"
 	"github.com/smacker/go-tree-sitter/cpp"
+	"github.com/smacker/go-tree-sitter/elixir"
 	"github.com/smacker/go-tree-sitter/golang"
 	"github.com/smacker/go-tree-sitter/html"
 	"github.com/smacker/go-tree-sitter/javascript"
@@ -88,10 +89,12 @@ func getLanguage(lang protocol.Language) (*sitter.Language, error) {
 	case protocol.LangVue:
 		// Vue SFC files use HTML-like template syntax, so we use the HTML parser
 		return html.GetLanguage(), nil
+	case protocol.LangElixir:
+		return elixir.GetLanguage(), nil
 	default:
 		return nil, errors.New(errors.ErrInvalidLanguage, fmt.Sprintf("language %s is not supported", lang)).
 			WithContext("language", string(lang)).
-			WithRemediation("Supported languages: Go, TypeScript, JavaScript, Python, C, C++, HTML, Vue")
+			WithRemediation("Supported languages: Go, TypeScript, JavaScript, Python, C, C++, HTML, Vue, Elixir")
 	}
 }
 

internal/parser/symbols.go

@@ -25,6 +25,8 @@ func ExtractSymbols(tree *sitter.Tree, content []byte, lang protocol.Language, f
 		return extractPythonSymbols(root, content, filename)
 	case protocol.LangC, protocol.LangCpp:
 		return extractCSymbols(root, content, filename)
+	case protocol.LangElixir:
+		return extractElixirSymbols(root, content, filename)
 	default:
 		return nil
 	}
@@ -472,3 +474,278 @@ func hasFunctionDeclarator(n *sitter.Node) bool {
 	})
 	return found
 }
+
+// extractElixirSymbols extracts symbols from Elixir code.
+// Elixir uses `defmodule` for modules, `def`/`defp` for functions, and `defmacro`/`defmacrop` for macros.
+func extractElixirSymbols(root *sitter.Node, content []byte, filename string) []protocol.Symbol {
+	var symbols []protocol.Symbol
+
+	WalkTree(root, func(n *sitter.Node) bool {
+		var symbol *protocol.Symbol
+
+		switch n.Type() {
+		case "call":
+			symbol = extractElixirCall(n, content, filename)
+		}
+
+		if symbol != nil {
+			if doc := ExtractDocComment(n, content, protocol.LangElixir); doc != nil {
+				symbol.Doc = FormatDocComment(doc)
+			}
+			symbols = append(symbols, *symbol)
+		}
+
+		return true
+	})
+
+	return symbols
+}
+
+// extractElixirCall extracts symbols from Elixir call nodes (def, defp, defmodule, defmacro, etc.).
+func extractElixirCall(n *sitter.Node, content []byte, filename string) *protocol.Symbol {
+	// Get the function being called (first child is usually the target)
+	if n.NamedChildCount() < 1 {
+		return nil
+	}
+
+	target := n.NamedChild(0)
+	if target == nil {
+		return nil
+	}
+
+	targetText := GetNodeText(target, content)
+
+	switch targetText {
+	case "defmodule":
+		return extractElixirModule(n, content, filename)
+	case "def", "defp":
+		return extractElixirFunction(n, content, filename, targetText == "defp")
+	case "defmacro", "defmacrop":
+		return extractElixirMacro(n, content, filename)
+	case "defstruct":
+		return extractElixirStruct(n, content, filename)
+	case "defprotocol":
+		return extractElixirProtocol(n, content, filename)
+	case "defimpl":
+		return extractElixirImpl(n, content, filename)
+	}
+
+	return nil
+}
+
+// extractElixirModule extracts a module definition.
+func extractElixirModule(n *sitter.Node, content []byte, filename string) *protocol.Symbol {
+	// defmodule ModuleName do ... end
+	// The module name is in the arguments
+	args := n.ChildByFieldName("arguments")
+	if args == nil {
+		// Try finding it as the second named child
+		if n.NamedChildCount() >= 2 {
+			args = n.NamedChild(1)
+		}
+	}
+	if args == nil {
+		return nil
+	}
+
+	// Find the alias (module name) in the arguments
+	var moduleName string
+	WalkTree(args, func(node *sitter.Node) bool {
+		if node.Type() == "alias" {
+			moduleName = GetNodeText(node, content)
+			return false
+		}
+		return true
+	})
+
+	if moduleName == "" {
+		return nil
+	}
+
+	return &protocol.Symbol{
+		Name:     moduleName,
+		Kind:     protocol.SymbolModule,
+		Location: NodeLocation(n, filename),
+	}
+}
+
+// extractElixirFunction extracts a function definition.
+func extractElixirFunction(n *sitter.Node, content []byte, filename string, isPrivate bool) *protocol.Symbol {
+	// def function_name(args) do ... end
+	// The function name and args are in the arguments of the call
+	if n.NamedChildCount() < 2 {
+		return nil
+	}
+
+	// Second child contains the function definition
+	funcDef := n.NamedChild(1)
+	if funcDef == nil {
+		return nil
+	}
+
+	var funcName string
+
+	// The function definition can be:
+	// 1. A call node (function with args): func_name(arg1, arg2)
+	// 2. An identifier (function without args): func_name
+	switch funcDef.Type() {
+	case "call":
+		// Get the function name from the call target
+		if funcDef.NamedChildCount() >= 1 {
+			nameNode := funcDef.NamedChild(0)
+			if nameNode != nil {
+				funcName = GetNodeText(nameNode, content)
+			}
+		}
+	case "identifier":
+		funcName = GetNodeText(funcDef, content)
+	case "binary_operator":
+		// Guard clause: def func_name(args) when guard do ... end
+		// The left side contains the actual function call
+		WalkTree(funcDef, func(node *sitter.Node) bool {
+			if node.Type() == "call" && node.NamedChildCount() >= 1 {
+				nameNode := node.NamedChild(0)
+				if nameNode != nil && nameNode.Type() == "identifier" {
+					funcName = GetNodeText(nameNode, content)
+					return false
+				}
+			}
+			if node.Type() == "identifier" && funcName == "" {
+				funcName = GetNodeText(node, content)
+				return false
+			}
+			return true
+		})
+	}
+
+	if funcName == "" {
+		return nil
+	}
+
+	kind := protocol.SymbolFunction
+	if isPrivate {
+		funcName = funcName + " (private)"
+	}
+
+	return &protocol.Symbol{
+		Name:     funcName,
+		Kind:     kind,
+		Location: NodeLocation(n, filename),
+	}
+}
+
+// extractElixirMacro extracts a macro definition.
+func extractElixirMacro(n *sitter.Node, content []byte, filename string) *protocol.Symbol {
+	// Similar to function extraction
+	if n.NamedChildCount() < 2 {
+		return nil
+	}
+
+	funcDef := n.NamedChild(1)
+	if funcDef == nil {
+		return nil
+	}
+
+	var macroName string
+
+	switch funcDef.Type() {
+	case "call":
+		if funcDef.NamedChildCount() >= 1 {
+			nameNode := funcDef.NamedChild(0)
+			if nameNode != nil {
+				macroName = GetNodeText(nameNode, content)
+			}
+		}
+	case "identifier":
+		macroName = GetNodeText(funcDef, content)
+	}
+
+	if macroName == "" {
+		return nil
+	}
+
+	return &protocol.Symbol{
+		Name:     macroName + " (macro)",
+		Kind:     protocol.SymbolFunction,
+		Location: NodeLocation(n, filename),
+	}
+}
+
+// extractElixirStruct extracts a struct definition.
+func extractElixirStruct(n *sitter.Node, content []byte, filename string) *protocol.Symbol {
+	// defstruct is typically inside a module, the struct name is the module name
+	// We just mark this as a struct symbol
+	return &protocol.Symbol{
+		Name:     "defstruct",
+		Kind:     protocol.SymbolStruct,
+		Location: NodeLocation(n, filename),
+	}
+}
+
+// extractElixirProtocol extracts a protocol definition.
+func extractElixirProtocol(n *sitter.Node, content []byte, filename string) *protocol.Symbol {
+	// defprotocol ProtocolName do ... end
+	if n.NamedChildCount() < 2 {
+		return nil
+	}
+
+	args := n.NamedChild(1)
+	if args == nil {
+		return nil
+	}
+
+	var protocolName string
+	WalkTree(args, func(node *sitter.Node) bool {
+		if node.Type() == "alias" {
+			protocolName = GetNodeText(node, content)
+			return false
+		}
+		return true
+	})
+
+	if protocolName == "" {
+		return nil
+	}
+
+	return &protocol.Symbol{
+		Name:     protocolName,
+		Kind:     protocol.SymbolInterface,
+		Location: NodeLocation(n, filename),
+	}
+}
+
+// extractElixirImpl extracts a protocol implementation.
+func extractElixirImpl(n *sitter.Node, content []byte, filename string) *protocol.Symbol {
+	// defimpl Protocol, for: Type do ... end
+	if n.NamedChildCount() < 2 {
+		return nil
+	}
+
+	args := n.NamedChild(1)
+	if args == nil {
+		return nil
+	}
+
+	var implName string
+	WalkTree(args, func(node *sitter.Node) bool {
+		if node.Type() == "alias" {
+			if implName == "" {
+				implName = GetNodeText(node, content)
+			} else {
+				implName = implName + " for " + GetNodeText(node, content)
+				return false
+			}
+		}
+		return true
+	})
+
+	if implName == "" {
+		return nil
+	}
+
+	return &protocol.Symbol{
+		Name:     implName,
+		Kind:     protocol.SymbolClass,
+		Location: NodeLocation(n, filename),
+	}
+}

internal/parser/symbols_test.go

@@ -224,3 +224,96 @@ int main() {
 		}
 	}
 }
+
+func TestExtractElixirSymbols(t *testing.T) {
+	r := NewRegistry()
+	defer r.Close()
+
+	content := `defmodule MyApp.User do
+  @moduledoc """
+  User module for the application.
+  """
+
+  defstruct [:name, :email]
+
+  @doc """
+  Creates a new user.
+  """
+  def new(name, email) do
+    %__MODULE__{name: name, email: email}
+  end
+
+  defp validate(user) do
+    # Private validation function
+    user
+  end
+
+  defmacro is_user(term) do
+    quote do
+      is_struct(unquote(term), __MODULE__)
+    end
+  end
+end
+
+defprotocol Greeting do
+  @doc "Greet the entity"
+  def greet(entity)
+end
+
+defimpl Greeting, for: MyApp.User do
+  def greet(user) do
+    "Hello, #{user.name}!"
+  end
+end
+`
+
+	ctx := context.Background()
+	result, err := r.Parse(ctx, "test.ex", []byte(content))
+	if err != nil {
+		t.Fatalf("parse failed: %v", err)
+	}
+
+	symbols := ExtractSymbols(result.Tree, []byte(content), protocol.LangElixir, "test.ex")
+
+	// Check that we found some symbols
+	if len(symbols) == 0 {
+		t.Fatal("expected to find some symbols")
+	}
+
+	// Look for specific expected symbols - we focus on top-level constructs
+	// that the current implementation can reliably extract
+	expectedSymbols := map[string]protocol.SymbolKind{
+		"MyApp.User": protocol.SymbolModule,
+		"Greeting":   protocol.SymbolInterface,
+	}
+
+	found := make(map[string]bool)
+	for _, sym := range symbols {
+		for name, expectedKind := range expectedSymbols {
+			if sym.Name == name {
+				found[name] = true
+				if sym.Kind != expectedKind {
+					t.Errorf("symbol %s: expected kind %s, got %s", sym.Name, expectedKind, sym.Kind)
+				}
+			}
+		}
+	}
+
+	for name := range expectedSymbols {
+		if !found[name] {
+			t.Errorf("expected to find symbol %s, found symbols: %v", name, symbols)
+		}
+	}
+
+	// Verify we found the defstruct
+	foundStruct := false
+	for _, sym := range symbols {
+		if sym.Kind == protocol.SymbolStruct {
+			foundStruct = true
+			break
+		}
+	}
+	if !foundStruct {
+		t.Error("expected to find a struct symbol")
+	}
+}

internal/server/server.go

@@ -670,6 +670,8 @@ func languageToExtension(language string) string {
 		return ".c"
 	case "cpp", "c++":
 		return ".cpp"
+	case "elixir":
+		return ".ex"
 	default:
 		return ""
 	}

pkg/protocol/types.go

@@ -60,6 +60,7 @@ const (
 	LangVue        Language = "vue"
 	LangJSON       Language = "json"
 	LangYAML       Language = "yaml"
+	LangElixir     Language = "elixir"
 	LangUnknown    Language = "unknown"
 )
 
@@ -87,6 +88,8 @@ func DetectLanguage(filename string) Language {
 		return LangJSON
 	case ".yaml", ".yml":
 		return LangYAML
+	case ".ex", ".exs":
+		return LangElixir
 	default:
 		return LangUnknown
 	}

pkg/protocol/types_test.go

@@ -29,10 +29,14 @@ func TestDetectLanguage(t *testing.T) {
 		{"index.html", LangHTML},
 		{"page.htm", LangHTML},
 		{"Component.vue", LangVue},
+		{"app.ex", LangElixir},
+		{"app_test.exs", LangElixir},
+		{"mix.exs", LangElixir},
 		{"unknown.txt", LangUnknown},
 		{"README", LangUnknown},
 		{"path/to/file.go", LangGo},
 		{"path/to/file.ts", LangTypeScript},
+		{"path/to/file.ex", LangElixir},
 	}
 
 	for _, tt := range tests {

scripts/install.sh

@@ -0,0 +1,388 @@
+#!/bin/bash
+
+# MCP Filepuff Installation Script
+# Downloads and installs the latest version of mcp-filepuff
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# GitHub repository information
+REPO="lukaszraczylo/filepuff-mcp"
+BINARY_NAME="mcp-filepuff"
+
+# Installation directory (will try ~/.local/bin first, then /usr/local/bin)
+INSTALL_DIR="${INSTALL_DIR:-$HOME/.local/bin}"
+
+# Functions
+print_info() {
+    printf "${GREEN}[INFO]${NC} %s\n" "$1"
+}
+
+print_warn() {
+    printf "${YELLOW}[WARN]${NC} %s\n" "$1"
+}
+
+print_error() {
+    printf "${RED}[ERROR]${NC} %s\n" "$1" >&2
+}
+
+detect_platform() {
+    local os
+    local arch
+
+    # Detect OS
+    case "$(uname -s)" in
+        Linux*)     os="linux" ;;
+        Darwin*)    os="darwin" ;;
+        MINGW*|MSYS*|CYGWIN*)
+            print_error "Windows is not directly supported. Please use WSL2."
+            exit 1
+            ;;
+        *)
+            print_error "Unsupported operating system: $(uname -s)"
+            exit 1
+            ;;
+    esac
+
+    # Detect architecture
+    case "$(uname -m)" in
+        x86_64|amd64)   arch="amd64" ;;
+        arm64|aarch64)  arch="arm64" ;;
+        *)
+            print_error "Unsupported architecture: $(uname -m)"
+            exit 1
+            ;;
+    esac
+
+    # Warn about unsupported combinations
+    if [ "$os" = "linux" ] && [ "$arch" = "arm64" ]; then
+        print_error "Linux ARM64 builds are not currently available due to CGO cross-compilation complexity"
+        print_error "Please build from source: https://github.com/lukaszraczylo/filepuff-mcp#build-from-source"
+        exit 1
+    fi
+
+    echo "${os}_${arch}"
+}
+
+check_dependencies() {
+    local missing_deps=()
+
+    # Check for required commands
+    for cmd in curl tar; do
+        if ! command -v "$cmd" &> /dev/null; then
+            missing_deps+=("$cmd")
+        fi
+    done
+
+    if [ ${#missing_deps[@]} -ne 0 ]; then
+        print_error "Missing required dependencies: ${missing_deps[*]}"
+        print_error "Please install them and try again."
+        exit 1
+    fi
+}
+
+detect_package_manager() {
+    if command -v brew &> /dev/null; then
+        echo "brew"
+    elif command -v apt-get &> /dev/null; then
+        echo "apt"
+    elif command -v yum &> /dev/null; then
+        echo "yum"
+    elif command -v pacman &> /dev/null; then
+        echo "pacman"
+    elif command -v apk &> /dev/null; then
+        echo "apk"
+    else
+        echo "unknown"
+    fi
+}
+
+install_prerequisites() {
+    local pkg_mgr="$1"
+    local install_lsp="${2:-false}"
+
+    print_info "Checking prerequisites..."
+    
+    # Check if ripgrep is installed
+    if ! command -v rg &> /dev/null; then
+        print_warn "ripgrep not found - required for file search functionality"
+        
+        case "$pkg_mgr" in
+            brew)
+                print_info "Installing ripgrep via Homebrew..."
+                brew install ripgrep
+                ;;
+            apt)
+                print_info "Installing ripgrep via apt..."
+                sudo apt-get update && sudo apt-get install -y ripgrep
+                ;;
+            yum)
+                print_info "Installing ripgrep via yum..."
+                sudo yum install -y ripgrep
+                ;;
+            pacman)
+                print_info "Installing ripgrep via pacman..."
+                sudo pacman -S --noconfirm ripgrep
+                ;;
+            apk)
+                print_info "Installing ripgrep via apk..."
+                sudo apk add --no-cache ripgrep
+                ;;
+            unknown)
+                print_error "Could not detect package manager"
+                print_error "Please install ripgrep manually: https://github.com/BurntSushi/ripgrep"
+                exit 1
+                ;;
+        esac
+    else
+        print_info "✓ ripgrep is already installed"
+    fi
+
+    if [ "$install_lsp" = "true" ]; then
+        print_info "Installing LSP servers for enhanced IDE features..."
+        
+        # Install gopls (Go LSP)
+        if command -v go &> /dev/null && ! command -v gopls &> /dev/null; then
+            print_info "Installing gopls (Go language server)..."
+            go install golang.org/x/tools/gopls@latest
+        fi
+
+        # Install typescript-language-server (TypeScript/JavaScript)
+        if command -v npm &> /dev/null && ! command -v typescript-language-server &> /dev/null; then
+            print_info "Installing typescript-language-server..."
+            npm install -g typescript-language-server typescript
+        fi
+
+        # Install pylsp (Python LSP)
+        if command -v pip3 &> /dev/null && ! python3 -c "import pylsp" 2>/dev/null; then
+            print_info "Installing python-lsp-server..."
+            pip3 install python-lsp-server
+        fi
+
+        # Install clangd (C/C++)
+        if ! command -v clangd &> /dev/null; then
+            case "$pkg_mgr" in
+                brew)
+                    print_info "Installing clangd via Homebrew..."
+                    brew install llvm
+                    ;;
+                apt)
+                    print_info "Installing clangd via apt..."
+                    sudo apt-get install -y clangd
+                    ;;
+                yum)
+                    print_info "Installing clangd via yum..."
+                    sudo yum install -y clang-tools-extra
+                    ;;
+                pacman)
+                    print_info "Installing clangd via pacman..."
+                    sudo pacman -S --noconfirm clang
+                    ;;
+            esac
+        fi
+    fi
+}
+
+get_latest_version() {
+    local version
+    version=$(curl -sSf "https://api.github.com/repos/${REPO}/releases/latest" | grep '"tag_name"' | cut -d'"' -f4)
+
+    if [ -z "$version" ]; then
+        print_error "Failed to fetch latest version from GitHub"
+        exit 1
+    fi
+
+    echo "$version"
+}
+
+download_and_install() {
+    local version="$1"
+    local platform="$2"
+    local tmpdir
+
+    tmpdir=$(mktemp -d)
+    trap 'rm -rf "$tmpdir"' EXIT
+
+    print_info "Downloading mcp-filepuff ${version} for ${platform}..."
+
+    # Construct download URLs
+    local archive_name="mcp-filepuff_${version#v}_${platform}.tar.gz"
+    local archive_url="https://github.com/${REPO}/releases/download/${version}/${archive_name}"
+    local checksum_url="https://github.com/${REPO}/releases/download/${version}/checksums.txt"
+
+    # Download archive
+    if ! curl -sSfL "$archive_url" -o "$tmpdir/$archive_name"; then
+        print_error "Failed to download $archive_url"
+        exit 1
+    fi
+
+    # Download checksums
+    if ! curl -sSfL "$checksum_url" -o "$tmpdir/checksums.txt"; then
+        print_warn "Failed to download checksums, skipping verification"
+    else
+        print_info "Verifying checksum..."
+        cd "$tmpdir"
+        
+        # Extract expected checksum for our archive
+        local expected_checksum
+        expected_checksum=$(grep "$archive_name" checksums.txt | awk '{print $1}')
+        
+        if [ -z "$expected_checksum" ]; then
+            print_warn "Checksum not found for $archive_name, skipping verification"
+        else
+            # Calculate actual checksum (use shasum on macOS, sha256sum on Linux)
+            local actual_checksum
+            if command -v sha256sum &> /dev/null; then
+                actual_checksum=$(sha256sum "$archive_name" | awk '{print $1}')
+            elif command -v shasum &> /dev/null; then
+                actual_checksum=$(shasum -a 256 "$archive_name" | awk '{print $1}')
+            else
+                print_warn "No checksum utility found, skipping verification"
+                cd - > /dev/null
+                return
+            fi
+            
+            if [ "$expected_checksum" = "$actual_checksum" ]; then
+                print_info "Checksum verification passed"
+            else
+                print_error "Checksum verification failed"
+                print_error "Expected: $expected_checksum"
+                print_error "Actual:   $actual_checksum"
+                exit 1
+            fi
+        fi
+        cd - > /dev/null
+    fi
+
+    # Extract archive
+    print_info "Extracting archive..."
+    tar -xzf "$tmpdir/$archive_name" -C "$tmpdir"
+
+    # Ensure install directory exists
+    if [ ! -d "$INSTALL_DIR" ]; then
+        print_info "Creating installation directory: $INSTALL_DIR"
+        mkdir -p "$INSTALL_DIR"
+    fi
+
+    # Install binary
+    print_info "Installing to $INSTALL_DIR/$BINARY_NAME..."
+    if [ -w "$INSTALL_DIR" ]; then
+        cp "$tmpdir/$BINARY_NAME" "$INSTALL_DIR/$BINARY_NAME"
+        chmod +x "$INSTALL_DIR/$BINARY_NAME"
+    else
+        print_warn "No write permission to $INSTALL_DIR, trying with sudo..."
+        sudo cp "$tmpdir/$BINARY_NAME" "$INSTALL_DIR/$BINARY_NAME"
+        sudo chmod +x "$INSTALL_DIR/$BINARY_NAME"
+    fi
+
+    print_info "Installation complete!"
+}
+
+check_path() {
+    if ! echo "$PATH" | grep -q "$INSTALL_DIR"; then
+        print_warn "$INSTALL_DIR is not in your PATH"
+        print_warn "Add it to your PATH by adding this line to your shell profile:"
+        echo ""
+        echo "    export PATH=\"\$PATH:$INSTALL_DIR\""
+        echo ""
+    fi
+}
+
+verify_installation() {
+    if command -v "$BINARY_NAME" &> /dev/null; then
+        local installed_version
+        installed_version=$("$BINARY_NAME" -version 2>&1 || echo "unknown")
+        print_info "Successfully installed: $installed_version"
+    else
+        print_warn "Binary installed but not found in PATH"
+        print_info "You can run it directly: $INSTALL_DIR/$BINARY_NAME"
+    fi
+}
+
+main() {
+    print_info "MCP Filepuff Installation Script"
+    echo ""
+
+    # Parse command line arguments
+    local install_lsp="false"
+    local skip_prereqs="false"
+    
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --with-lsp)
+                install_lsp="true"
+                shift
+                ;;
+            --skip-prereqs)
+                skip_prereqs="true"
+                shift
+                ;;
+            --help)
+                echo "Usage: install.sh [OPTIONS]"
+                echo ""
+                echo "Options:"
+                echo "  --with-lsp       Install LSP servers (gopls, typescript-language-server, pylsp, clangd)"
+                echo "  --skip-prereqs   Skip prerequisite installation (ripgrep, LSP servers)"
+                echo "  --help           Show this help message"
+                exit 0
+                ;;
+            *)
+                print_error "Unknown option: $1"
+                print_error "Use --help for usage information"
+                exit 1
+                ;;
+        esac
+    done
+
+    # Check dependencies
+    check_dependencies
+
+    # Detect platform
+    local platform
+    platform=$(detect_platform)
+    print_info "Detected platform: $platform"
+
+    # Detect package manager
+    local pkg_mgr
+    pkg_mgr=$(detect_package_manager)
+    print_info "Detected package manager: $pkg_mgr"
+    echo ""
+
+    # Install prerequisites unless skipped
+    if [ "$skip_prereqs" != "true" ]; then
+        install_prerequisites "$pkg_mgr" "$install_lsp"
+        echo ""
+    fi
+
+    # Get latest version
+    local version
+    version=$(get_latest_version)
+    print_info "Latest version: $version"
+    echo ""
+
+    # Download and install
+    download_and_install "$version" "$platform"
+    echo ""
+
+    # Check PATH
+    check_path
+
+    # Verify installation
+    verify_installation
+    echo ""
+
+    print_info "To get started, run: $BINARY_NAME --help"
+    
+    if [ "$install_lsp" != "true" ]; then
+        echo ""
+        print_info "Tip: Run with --with-lsp to install LSP servers for enhanced IDE features"
+    fi
+}
+
+# Run main function
+main "$@"