🟦 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é
| Agent | Fichier de configuration LSP | Format |
|---|---|---|
| GitHub Copilot CLI | com.github.copilot/lsp.json | Agent Plugins 1.0 (plugin.json racine) |
| Claude Code | .lsp.json | Plugin 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 --versiondoit 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
| Extension | Identifiant de langage |
|---|---|
.ts | typescript |
.mts | typescript |
.cts | typescript |
.tsx | typescriptreact |
.js | javascript |
.mjs | javascript |
.cjs | javascript |
.jsx | javascriptreact |
💡 Conseils
- Un
tsconfig.json(oujsconfig.jsonpour du JavaScript pur) à la racine améliore fortement la résolution des modules. - Pour vérifier les types dans des fichiers JavaScript, activez
"checkJs": truedansjsconfig.json. - Projet bloqué en TypeScript 6 ou antérieur ? Installez
npm install -g typescript-language-server typescript@6puis remplacez la commande partypescript-language-serveret les arguments par["--stdio"]dans.lsp.jsonetcom.github.copilot/lsp.json.
🛠️ Dépannage
| Symptôme | Solution |
|---|---|
/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