Claude Launcher

Le problème

Travailler avec Claude Code sur plusieurs projets, sans outil dédié, devient vite ingérable.

🪟

Fenêtres éparpillées

Un terminal par projet, aucune vue d'ensemble, on perd le fil de ce qui tourne où.

🎯

Panes indistincts

Plusieurs agents actifs dans la même fenêtre tmux, impossible de repérer au premier coup d'œil lequel a le focus.

🔄

Setup répétitif

Retélécharger `init-project.md`, relancer `claude`, revérifier la config — à chaque nouvelle session.

📌

Version périmée

Un script installé une fois et jamais mis à jour manque les correctifs et nouveautés.

Ce que fait le launcher

Un hub central en tmux — pas un remplacement de Claude Code, juste l'orchestration autour.

🗂️

Sessions groupées par projet

Chaque projet ouvert dans sa propre session tmux, navigable depuis un menu fzf — pas besoin de mémoriser des noms de session.

🎨

Panes colorés

Le pane actif s'éclaire, les autres s'assombrissent — le focus se repère visuellement sans avoir à lire les titres.

🔁

Auto-update silencieux

Le launcher vérifie le dernier tag GitHub à l'ouverture et se met à jour tout seul si une nouvelle version existe — repli sur la version locale si GitHub est inaccessible.

📄

Template toujours à jour

init-project.md est resynchronisé depuis GitHub à chaque ouverture de projet, sans action manuelle.

🔑

Config flexible

EXTRA_ENVS passe n'importe quelle variable d'environnement à Claude Code — clés d'API tierces, URLs de service, etc.

🧩

Pas lié à un template

Fonctionne avec n'importe quel projet Claude Code — claude_project_template est un compagnon naturel, pas une dépendance obligatoire.

Installation

Trois commandes, aucune configuration obligatoire pour démarrer.

Télécharger le script

Un seul fichier Bash, exécutable direct.

curl -fsSL \
  https://raw.githubusercontent.com/CCoupel/Claude-Launcher/main/claude-launcher.sh \
  -o ~/claude-launcher.sh && chmod +x ~/claude-launcher.sh

Configurer (optionnel)

Au premier lancement, le launcher crée ~/.config/claude-launcher.conf.

~/claude-launcher.sh --configure   # édite GITHUB_DIR, token…

Variable	Rôle
`GITHUB_DIR`	Répertoire contenant vos projets
`GITHUB_TOKEN`	Token GitHub (gh CLI + MCP)
`CLAUDE_DISABLE_MOUSE`	`1` = désactive la souris
`CLAUDE_EXPERIMENTAL_TEAMS`	`1` = active les agent teams
`CLAUDE_OPTIONS`	Options passées à `claude`
`EXTRA_ENVS`	Variables d'environnement supplémentaires

EXTRA_ENVS=(
  "ANTHROPIC_API_KEY=sk-ant-..."
  "MY_API_URL=https://api.example.com"
)

Démarrer le hub

~/claude-launcher.sh

✓ Vérifie le dernier tag GitHub, se met à jour si besoin

✓ Resynchronise init-project.md

✓ Lance /init-project ensuite dans Claude Code

~/claude-launcher.sh --update   # force la mise à jour, préserve la config

Un hub tmux pour piloter plusieurs projets Claude Code en parallèle