Skip to content

typescript-lsp

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

typescript-lsp

Folders and files

README.md

🟦 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 --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

Extension Identifiant de langage
.ts typescript
.mts typescript
.cts typescript
.tsx typescriptreact
.js javascript
.mjs javascript
.cjs javascript
.jsx javascriptreact

💡 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ô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