Télécharger

Installer Tarmac

Tarmac est gratuit et open source (MIT). Il tourne sur votre machine, s’ouvre dans votre navigateur et s’installe comme une app (PWA). Vous préférez un installateur en un double clic, avec mises à jour automatiques ? C’est Tarmac Pro.

Prérequis

  • macOS (Apple silicon ou Intel), ou Windows 10/11 avec WSL 2.
  • Node.js 22.13 ou plus.
  • Facultatif : la CLI GitHub (gh), Docker Desktop, OrbStack ou Colima (vue Docker, Supabase en local), Claude Code et/ou Codex (sessions d’agents et Todolist).

macOS

npm install -g @codustel/tarmac
tarmac setup

tarmac setup installe un service de connexion puis, avec votre accord, fait fonctionner http://tarmac.localhost et propose de configurer l’intégration Claude Code. Lancez d’abord tarmac setup --dry-run pour voir chaque action sans rien changer ; --no-sudo saute les étapes facultatives qui demandent votre mot de passe.

L’adresse qui marche toujours est http://tarmac.localhost:7777.

Windows (WSL 2)

Sous Windows, la version gratuite de Tarmac tourne dans WSL 2 et se lance à la main. Le tableau de bord, la détection des projets, les ports et les logs en direct, les consoles, le menu Git, GitHub, Supabase en local et la Todolist fonctionnent.

  1. Dans PowerShell, installez Ubuntu :

    wsl --install -d Ubuntu

  2. Dans le terminal Ubuntu, installez les outils, puis Node.js 22.13 ou plus (par exemple nvm install 22) et pnpm (corepack enable) :

    sudo apt update && sudo apt install -y git lsof build-essential python3

  3. Récupérez Tarmac et lancez-le :

    git clone https://github.com/codustel/tarmac.git ~/tarmac
cd ~/tarmac
pnpm install
pnpm build
DEV_ROOTS=~/dev node dist/server/index.js

  4. Ouvrez http://localhost:7777 dans Edge ou Chrome. DEV_ROOTS liste les dossiers à parcourir ; vous pourrez les changer ensuite dans les Réglages.

Vous préférez une app native avec mises à jour automatiques ? Voyez Tarmac Pro.

Premiers pas

  1. Ouvrez Tarmac (tarmac open sur macOS) et cliquez sur Installer l’app pour avoir une icône dans le Dock ou la barre des tâches.
  2. Dans les Réglages, vérifiez les dossiers à parcourir, puis connectez la CLI GitHub en un clic.
  3. Lancez une app avec Démarrer, ouvrez sa console, ou une session d’agent depuis son onglet Claude ou Codex (cochez d’abord Codex dans Réglages → Agents).
  4. Tapez /suivi init dans une session Claude Code, ou $suivi init dans une session Codex, pour créer la Todolist du projet.

Commandes utiles (macOS)

tarmac status | start | stop | restart | logs | open
tarmac doctor     # vérifie Node, le service, le port, le domaine, gh, Docker et Claude Code
tarmac update     # installe la dernière version, puis redémarre

Sous Windows, mettez à jour avec git pull && pnpm install && pnpm build, puis relancez Tarmac.

Désinstaller

tarmac uninstall            # service, configuration de l'adresse, serveur MCP de Claude Code
tarmac uninstall --purge    # la même chose, et supprime ~/.tarmac
npm uninstall -g @codustel/tarmac

Besoin d’aide ?

Lancez tarmac doctor, lisez le guide de dépannage du dépôt GitHub, ou ouvrez-y une issue.