stackpick

CLI interactif pour installer ton environnement de dev — choisis tes outils, stackpick s'occupe d'utiliser le bon gestionnaire de paquets selon ton OS (macOS, Windows, Linux) et la dernière version.

npx stackpick

Un menu interactif s'affiche, regroupé par catégorie. Coche ce que tu veux, valide, c'est installé.

✨ Pourquoi

Réinstaller sa machine de dev, c'est une heure perdue à copier-coller des commandes brew install / winget install / curl … | sh. stackpick rassemble 49 outils avec, pour chacun, la meilleure méthode d'installation officielle vérifiée sur chaque plateforme, et te laisse choisir d'un clic.

• 🖱️ Sélection interactive par catégories (propulsée par @clack/prompts).
• 🧠 Détection de l'OS et de l'architecture (Intel / Apple Silicon, x64 / arm64).
• 📦 Hybride « gestionnaire d'abord » : Homebrew sur macOS, winget/Scoop sur Windows, apt/dnf/pacman sur Linux, avec repli automatique sur les scripts officiels ou le téléchargement direct.
• ⚡ Rapide : les outils déjà présents sont détectés et ignorés ; installations parallélisées quand c'est sûr.
• 🧪 Sans surprise : --dry-run affiche exactement les commandes qui seront lancées.

🚀 Installation & usage

Aucune installation requise :

npx stackpick           # menu interactif

Ou en global :

npm install -g stackpick
stackpick

Options

| Option | Description | |---|---| | -a, --all | Installe tout le catalogue compatible avec ton OS | | -o, --only <ids> | IDs séparés par des virgules (ex : node,git,vscode) | | -c, --category <noms> | Filtre par catégories (ex : editeurs,ia) | | -y, --yes | Pas de confirmation | | --dry-run | Affiche les commandes sans rien installer | | --force | Réinstalle même si déjà présent | | --concurrency <n> | Nombre d'installations en parallèle | | --no-detect | Ne pré-détecte pas les outils déjà installés | | -l, --list | Affiche le catalogue puis quitte | | -v, --version | Version |

Exemples

stackpick --only node,pnpm,git,vscode,claude-code   # une stack précise
stackpick --category "Outils IA" --yes              # toute une catégorie
stackpick --all --dry-run                           # voir ce qui serait installé
stackpick --list                                    # lister le catalogue

📦 Catalogue (49 outils)

✅ = installation supportée · — = pas de distribution officielle pour cet OS

Runtimes & gestionnaires de paquets

| Outil | macOS | Windows | Linux | |---|:--:|:--:|:--:| | Node.js (node) | ✅ | ✅ | ✅ | | pnpm (pnpm) | ✅ | ✅ | ✅ | | Yarn (yarn) | ✅ | ✅ | ✅ | | Bun (bun) | ✅ | ✅ | ✅ | | Deno (deno) | ✅ | ✅ | ✅ | | Git (git) | ✅ | ✅ | ✅ |

Langages & gestionnaires de versions

| Outil | macOS | Windows | Linux | |---|:--:|:--:|:--:| | Python (CPython) (python) | ✅ | ✅ | ✅ | | Go (Golang) (go) | ✅ | ✅ | ✅ | | Rust (rustup) (rust) | ✅ | ✅ | ✅ | | Java JDK (Temurin) (java) | ✅ | ✅ | ✅ | | fnm (fnm) | ✅ | ✅ | ✅ | | nvm (nvm) | ✅ | — | ✅ | | pyenv (pyenv) | ✅ | ✅ | ✅ | | Volta (volta) | ✅ | ✅ | ✅ |

Éditeurs & IDE

| Outil | macOS | Windows | Linux | |---|:--:|:--:|:--:| | Visual Studio Code (vscode) | ✅ | ✅ | ✅ | | Cursor (cursor) | ✅ | ✅ | ✅ | | Zed (zed) | ✅ | ✅ | ✅ | | Windsurf (windsurf) | ✅ | ✅ | ✅ | | Sublime Text (sublime) | ✅ | ✅ | ✅ | | Neovim (neovim) | ✅ | ✅ | ✅ | | JetBrains Toolbox (jetbrains-toolbox) | ✅ | ✅ | ✅ |

Outils IA

| Outil | macOS | Windows | Linux | |---|:--:|:--:|:--:| | OpenAI Codex CLI (codex) | ✅ | ✅ | ✅ | | Claude Desktop (claude) | ✅ | ✅ | — | | Claude Code CLI (claude-code) | ✅ | ✅ | ✅ | | Aider (aider) | ✅ | ✅ | ✅ | | Ollama (ollama) | ✅ | ✅ | ✅ | | LM Studio (lm-studio) | ✅ | ✅ | ✅ | | GitHub Copilot CLI (copilot-cli) | ✅ | ✅ | ✅ |

CLI essentiels

| Outil | macOS | Windows | Linux | |---|:--:|:--:|:--:| | GitHub CLI (gh) | ✅ | ✅ | ✅ | | jq (jq) | ✅ | ✅ | ✅ | | ripgrep (ripgrep) | ✅ | ✅ | ✅ | | fzf (fzf) | ✅ | ✅ | ✅ | | Starship (starship) | ✅ | ✅ | ✅ | | Oh My Zsh (oh-my-zsh) | ✅ | — | ✅ | | Wget (wget) | ✅ | ✅ | ✅ |

Conteneurs, lanceurs & navigateur

| Outil | macOS | Windows | Linux | |---|:--:|:--:|:--:| | Docker Desktop (docker) | ✅ | ✅ | ✅ | | OrbStack (orbstack) | ✅ | — | — | | Raycast (raycast) | ✅ | ✅ | — | | Microsoft PowerToys (powertoys) | — | ✅ | — | | Helium (helium) | ✅ | ✅ | ✅ |

Terminaux

| Outil | macOS | Windows | Linux | |---|:--:|:--:|:--:| | Warp (warp) | ✅ | ✅ | ✅ | | Ghostty (ghostty) | ✅ | — | ✅ | | WezTerm (wezterm) | ✅ | ✅ | ✅ | | Windows Terminal (windows-terminal) | — | ✅ | — |

Bases de données & API

| Outil | macOS | Windows | Linux | |---|:--:|:--:|:--:| | Postman (postman) | ✅ | ✅ | ✅ | | Bruno (bruno) | ✅ | ✅ | ✅ | | Insomnia (insomnia) | ✅ | ✅ | ✅ | | TablePlus (tableplus) | ✅ | ✅ | ✅ | | DBeaver Community (dbeaver) | ✅ | ✅ | ✅ |

⚙️ Comment ça marche

Pour chaque outil, le catalogue (src/catalog.json) décrit une stratégie d'installation par plateforme :

{
  "id": "cursor",
  "detect": "cursor --version || test -d /Applications/Cursor.app",
  "macos":   { "manager": "brew",   "ref": "cursor", "cask": true },
  "windows": { "manager": "winget", "ref": "Anysphere.Cursor" },
  "linux":   { "manager": "download", "ref": "https://www.cursor.com/download" }
}

À l'exécution, stackpick :

1. détecte ton OS/arch et les gestionnaires présents ;
2. pour chaque outil sélectionné, lance detect pour ignorer ce qui est déjà installé ;
3. exécute la stratégie principale (gestionnaire natif), avec repli automatique sur la stratégie secondaire (script officiel ou téléchargement) si le gestionnaire est absent ou échoue ;
4. les ProductId du Microsoft Store (ex. Raycast) sont automatiquement routés vers --source msstore.

Les installations qui requièrent sudo (apt/dnf/pacman) ou une interaction GUI (.dmg, AppImage) sont gérées au mieux ; stackpick t'indique clairement ce qui reste à finaliser à la main.

🛠️ Développement

git clone https://github.com/Fazycks/stackpick.git
cd stackpick
npm install

npm run dev -- --list     # exécuter en TS sans build (tsx)
npm run typecheck         # tsc --noEmit
npm test                  # vitest
npm run build             # bundle ESM via tsup -> dist/

Stack : TypeScript · tsup · vitest · @clack/prompts · commander · execa.

Ajouter un outil

Ajoute une entrée dans src/catalog.json en suivant le type Tool de src/types.ts, puis npm test pour valider la structure. PRs bienvenues.

📄 Licence

MIT © Fazycks