Skip to content

sebastiendegodez/typescript-lsp

v1.0.0Apache-2.0

TypeScript and JavaScript language server (TypeScript 7 native tsc --lsp) for GitHub Copilot CLI and Claude Code

🟦 typescript-lsp

Un seul serveur pour TypeScript et JavaScript (y compris JSX/TSX) : le serveur LSP natif de TypeScript 7, réécrit en Go et nettement plus rapide.

GitHub Copilot CLI Claude Code Agent Plugins Licence

Ce plugin branche le serveur de langage TypeScript 7 (serveur LSP natif) sur votre agent IA. Au lieu de deviner la structure du code par recherche textuelle, l'agent interroge le serveur comme le ferait un IDE : résultats plus précis, plus rapides et moins coûteux en contexte.

✨ Ce que votre agent sait faire avec ce plugin

CapacitéExemple de demande
🎯 Aller à la définition« Où est défini ce symbole ? »
🔎 Trouver les références« Qui appelle cette fonction ? »
✏️ Renommer un symbole« Renomme cette classe dans tout le projet »
🩺 Diagnostics« Corrige les erreurs signalées dans ce fichier »
💬 Survol (types, documentation)« Quel est le type de cette variable ? »
🗺️ Symboles du document et de l'espace de travail« Liste les classes de ce module »

Les capacités réellement disponibles dépendent de ce que le serveur implémente.

🧩 Compatibilité

AgentFichier de configuration LSPFormat
GitHub Copilot CLIcom.github.copilot/lsp.jsonAgent Plugins 1.0 (plugin.json racine)
Claude Code.lsp.jsonPlugin Claude Code (.claude-plugin/plugin.json)

Les deux fichiers décrivent le même serveur (tsc --lsp --stdio). Ils existent en double car les deux agents n'utilisent pas les mêmes noms de champs (fileExtensions pour Copilot, extensionToLanguage pour Claude).

📋 Prérequis

  • Node.js 18+
  • TypeScript 7+ installé globalement (tsc --version doit afficher 7.x)

⚙️ 1. Installer le serveur de langage

Le plugin ne contient que la configuration : le serveur doit être installé sur votre machine et accessible dans le PATH.

npm

npm install -g typescript@latest

📦 2. Installer le plugin

GitHub Copilot CLI

copilot plugin marketplace add SebastienDegodez/copilot-instructions
copilot plugin install typescript-lsp@copilot-instructions-sebastien-degodez

Ou directement, sans passer par la marketplace :

copilot plugin install SebastienDegodez/copilot-instructions:plugins/typescript-lsp

Claude Code

/plugin marketplace add SebastienDegodez/copilot-instructions
/plugin install typescript-lsp@copilot-instructions-sebastien-degodez

✅ 3. Vérifier que tout fonctionne

Dans GitHub Copilot CLI :

/lsp list
/lsp test typescript

Dans Claude Code : ouvrez une nouvelle session dans votre projet, puis demandez par exemple « Trouve toutes les références de maFonction ». En cas de souci, claude --debug affiche les journaux de démarrage du serveur.

🗂️ Fichiers pris en charge

ExtensionIdentifiant de langage
.tstypescript
.mtstypescript
.ctstypescript
.tsxtypescriptreact
.jsjavascript
.mjsjavascript
.cjsjavascript
.jsxjavascriptreact

💡 Conseils

  • Un tsconfig.json (ou jsconfig.json pour du JavaScript pur) à la racine améliore fortement la résolution des modules.
  • Pour vérifier les types dans des fichiers JavaScript, activez "checkJs": true dans jsconfig.json.
  • Projet bloqué en TypeScript 6 ou antérieur ? Installez npm install -g typescript-language-server typescript@6 puis remplacez la commande par typescript-language-server et les arguments par ["--stdio"] dans .lsp.json et com.github.copilot/lsp.json.

🛠️ Dépannage

SymptômeSolution
/lsp test typescript échoue avec « command not found »Le binaire n'est pas dans le PATH : relancez l'étape 1 et ouvrez un nouveau terminal.
error TS5023: Unknown compiler option '--lsp'Un ancien tsc (TypeScript 6 ou moins) est prioritaire dans le PATH : lancez npm install -g typescript@latest et vérifiez avec which tsc.

Pour désactiver ce serveur dans un dépôt précis (Copilot CLI), ajoutez dans .github/lsp.json :

{ "lspServers": { "typescript": { "disabled": true } } }

📁 Structure du plugin

typescript-lsp/
├── plugin.json                      # Manifeste Agent Plugins 1.0 (Copilot CLI)
├── .claude-plugin/
│   └── plugin.json                  # Manifeste Claude Code
├── .lsp.json                        # Serveur LSP pour Claude Code
├── com.github.copilot/
│   └── lsp.json                     # Serveur LSP pour Copilot CLI
├── plugin.yaml                      # Métadonnées du site de documentation
└── README.md

🔗 Liens utiles


Auteur : Sebastien DEGODEZ · Licence : Apache 2.0