Terminal Macros

Des boutons pour lancer vos commandes dans un terminal VSCode : barre d'état (en bas), panneau latéral (icône terminal à gauche) et raccourci Ctrl+Alt+M.

Panneau latéral

Action	Comment
Exécuter	clic sur la macro
Ajouter / Réglages	boutons `+` et `⚙` en haut du panneau
Exécuter, arrêter, modifier, supprimer	icônes au survol de la macro
Réordonner	glisser-déposer (ou clic droit → Monter/Descendre)
Dupliquer, masquer de la barre d'état	clic droit

Une macro dont le terminal tourne s'affiche en vert avec un ● et compte dans le badge du panneau. Une suppression peut être annulée depuis la notification.

Créer (+) : nom → icône (galerie) → commande. Modifier (✎) : toutes les propriétés dans une liste (nom, icône, couleur, info-bulle, commande, dossier, terminal…), sauvegarde immédiate, Échap pour sortir.

Scripts du projet

Les fichiers .bat, .cmd, .sh, .bash et .ps1 du dossier scripts/ à la racine du projet apparaissent automatiquement dans le panneau — chaque projet a donc ses propres commandes, sans configuration. Clic pour exécuter (terminal ouvert à la racine du projet), clic droit pour ouvrir le fichier ou l'épingler comme macro (📌 copie dans vos réglages personnels).

Personnalisation (`scripts/macros.json`)

✎ sur un script (ou clic droit → « Personnaliser le script ») ouvre le même hub d'édition que les macros : nom, icône, couleur, info-bulle, commande, arguments, dossier, terminal, bouton de barre d'état… Tout est écrit dans scripts/macros.json, créé au besoin — donc versionné avec le projet et partagé avec l'équipe, contrairement aux macros qui vivent dans vos réglages VSCode.

Le fichier se modifie aussi à la main (icône {} sur le groupe « Scripts du projet ») :

{
  "defaults": { "closeOnFinish": false },
  "scripts": {
    "deploy.sh": {
      "label": "Déployer",
      "icon": "rocket",
      "color": "#89d185",
      "tooltip": "Déploiement en production",
      "args": "--prod",
      "showInStatusBar": true,
      "order": 1
    },
    "sub/clean.ps1": { "hidden": true }
  }
}

La clé est le chemin du script relatif au dossier scripts/ (sub/clean.ps1) ; le nom seul (clean.ps1) suffit s'il est unique. La casse et le sens des séparateurs sont ignorés. defaults s'applique à tous les scripts du projet, chaque entrée le surcharge.

Propriété	Rôle
`label`	Nom affiché (défaut : le chemin du fichier).
`icon`	Codicon (défaut : selon l'extension).
`color`	Couleur du bouton de barre d'état : `#ffcc00` ou une couleur de thème.
`tooltip`	Texte ajouté à l'info-bulle.
`command`	Commande complète, remplace le lanceur. `${script}` = le fichier, `${workspaceFolder}`, `${file}`.
`runner`	Modèle de lancement pour ce script seul (surcharge `terminalMacros.scriptRunners`).
`args`	Arguments ajoutés à la fin de la commande.
`cwd`	Répertoire de travail (défaut : la racine du projet).
`terminalName`	Nom du terminal (défaut : le nom du fichier).
`closeOnFinish`	Surcharge le réglage global de fermeture du terminal.
`showInStatusBar`	`true` = le script gagne son bouton dans la barre d'état.
`hidden`	`true` = retiré du panneau, de `Ctrl+Alt+M` et de la barre d'état.
`order`	Ordre d'affichage ; écrit automatiquement par le glisser-déposer.

Le glisser-déposer réordonne les scripts (il écrit order), et le groupe « Scripts du projet » indique le nombre de scripts masqués — l'icône de filtre les réaffiche temporairement pour les récupérer.

Réglages (`Ctrl+,` → « Terminal Macros »)

Setting	Défaut	Rôle
`terminalMacros.buttons`	2 exemples	Vos macros. Défini dans le `.vscode/settings.json` d'un projet, il ne s'applique qu'à ce projet.
`terminalMacros.closeTerminalOnFinish`	`true`	Ferme le terminal dès que la commande est terminée. Décocher pour garder la sortie à l'écran : le même terminal est alors réutilisé à chaque exécution.
`terminalMacros.detectProjectScripts`	`true`	Détection du dossier de scripts.
`terminalMacros.scriptsFolder`	`"scripts"`	Nom du dossier scanné.
`terminalMacros.scriptsConfigFile`	`"macros.json"`	Nom du fichier de personnalisation, dans ce dossier.
`terminalMacros.scriptRunners`	`{}`	Lanceur par extension, `${script}` = le fichier. Ex. `{ "sh": "wsl bash \"${script}\"" }`.

"terminalMacros.buttons": [
    { "label": "$(play) Dev", "command": "npm run dev" },
    { "label": "$(rocket) Docker", "command": "docker compose up", "cwd": "${workspaceFolder}" }
]

Propriété	Rôle
`label` ✅	Texte du bouton, avec codicon optionnel : `$(play) Dev`.
`command` ✅	Commande shell. Supporte `${workspaceFolder}` et `${file}`.
`tooltip`	Info-bulle au survol.
`cwd`	Répertoire de travail du terminal.
`terminalName`	Nom du terminal (défaut : le label sans icône).
`closeOnFinish`	Surcharge le réglage global de fermeture pour cette macro.
`color`	`#ffcc00` ou une couleur de thème (`statusBarItem.warningForeground`).
`showInStatusBar`	`false` = macro visible seulement dans le panneau.

Installation

Lancer scripts/install.bat : l'extension est empaquetée puis installée. Recharger ensuite VSCode (Ctrl+Shift+P → « Reload Window »).

npx --yes @vscode/vsce package -o terminal-macros.vsix
code --install-extension .\terminal-macros.vsix --force

Pour développer : ouvrir le dossier dans VSCode et appuyer sur F5.

Speed Terminal Macros

TauMah

Terminal Macros

Panneau latéral

Scripts du projet

Personnalisation (`scripts/macros.json`)

Réglages (`Ctrl+,` → « Terminal Macros »)

Installation

Speed Terminal Macros

TauMah

Terminal Macros

Panneau latéral

Scripts du projet

Personnalisation (scripts/macros.json)

Réglages (Ctrl+, → « Terminal Macros »)

Installation

Personnalisation (`scripts/macros.json`)

Réglages (`Ctrl+,` → « Terminal Macros »)