LSP Setup

The Language Server Protocol (LSP) allows Kodezi CLI to understand your code with deep intelligence, including real-time diagnostics, type checking, symbol resolution, and structural analysis. With LSP configured, Kodezi becomes significantly smarter and more accurate.

Supported Languages

Kodezi CLI supports any language that provides an LSP server, including:

Common LSP Servers:

• JavaScript / TypeScript
• Python
• Go
• Rust
• Java
• C / C++
• PHP
• Ruby
• Kotlin
• C#
• Swift
• And many more

If a language has an LSP server, Kodezi can use it.

Install LSP Servers

Choose a language below and follow the installation instructions.

npm install -g typescript typescript-language-server

{
  "lsp": {
    "typescript": {
      "command": "typescript-language-server",
      "args": ["--stdio"]
    }
  }
}

pip install python-lsp-server

{
  "lsp": {
    "python": {
      "command": "pylsp",
      "args": []
    }
  }
}

go install golang.org/x/tools/gopls@latest

{
  "lsp": {
    "go": {
      "command": "gopls",
      "args": []
    }
  }
}

rustup component add rust-analyzer

{
  "lsp": {
    "rust": {
      "command": "rust-analyzer",
      "args": []
    }
  }
}

LSP Configuration

You can configure LSP servers in:

Global Config

~/.config/kodezi-cli/kodezi-cli.json

Project Config

kodezi-cli.json

Example Full Configuration

{
  "lsp": {
    "typescript": {
      "command": "typescript-language-server",
      "args": ["--stdio"],
      "filetypes": ["ts", "tsx", "js", "jsx"],
      "root_markers": ["package.json", "tsconfig.json"]
    },
    "python": {
      "command": "pylsp",
      "args": [],
      "filetypes": ["py"],
      "root_markers": ["setup.py", "pyproject.toml"]
    }
  }
}

Configuration Options

Project Specific Configuration

Add to kodezi-cli.json in your project:

{
  "lsp": {
    "typescript": {
      "init_options": {
        "preferences": {
          "strictNullChecks": true
        }
      }
    }
  }
}

Useful when:

• A project requires strict rules
• You use specific tsconfig or venv
• Different repos use different LSP setups

Environment Variables

Use environment variables for custom paths:

{
  "lsp": {
    "python": {
      "env": {
        "PYTHONPATH": "/custom/path"
      }
    }
  }
}

Using LSP

Once configured, LSP runs automatically. The AI uses LSP diagnostics to:

• Detect errors before running code
• Understand type systems
• Validate changes immediately
• Access symbol definitions

Troubleshooting

Advanced Configuration

Custom Root Markers

{
  "lsp": {
    "typescript": {
      "root_markers": [
        "package.json",
        "tsconfig.json",
        ".git"
      ]
    }
  }
}

Server Specific Settings

{
  "lsp": {
    "python": {
      "options": {
        "pylsp": {
          "plugins": {
            "pycodestyle": {"enabled": true},
            "pylint": {"enabled": true}
          }
        }
      }
    }
  }
}

Related Topics

• Settings: All configuration options
• Configuration: Configuration overview
• MCP Setup: Extend Kodezi CLI with tools