HaikoDev n'est pas un service en ligne auquel on s'abonne : c'est un programme que vous installez sur votre machine. Il y range vos projets, y lance les agents et n'envoie au-dehors que ce que les moteurs que vous avez choisis reçoivent. Ce guide part de rien et va jusqu'à un tableau qui tourne en permanence.

Comptez une petite soirée la première fois. Aucune étape ne demande d'être développeur, mais toutes se font dans un terminal : si les commandes vous parlent peu, recopiez-les telles quelles, dans l'ordre.

Ce qu'il faut avant de commencer

  • Une machine sous Linux qui reste allumée : un petit serveur loué suffit largement.
  • Node.js version 22 ou plus — c'est le moteur qui fait tourner le programme.
  • git, l'outil qui sait récupérer un dépôt de code.
  • Un compte GitHub, et l'accès au dépôt HaikoDev (voir l'étape 1).
  • Au moins un moteur d'IA déjà installé et connecté en ligne de commande : Claude Code, Codex ou Cursor. HaikoDev les pilote, il ne les remplace pas.
Vérifier ce qui est déjà là
node --version   # doit afficher v22 ou plus
git --version

Étape par étape

  1. Obtenir l'accès au dépôt

    Le dépôt de HaikoDev vit à l'adresse https://github.com/haikostudio/haikodev. Il est aujourd'hui en accès restreint : ouvrez-le dans votre navigateur, et si GitHub affiche une page introuvable, c'est que votre compte n'y a pas encore été invité. Demandez l'invitation, acceptez-la, puis rechargez la page — vous devez voir la liste des fichiers.

    Il faut ensuite que votre machine, elle aussi, puisse s'y connecter. Le plus simple est l'outil officiel de GitHub :

    Connecter la machine à GitHub
    gh auth login    # suivez les questions : GitHub.com, HTTPS, connexion par navigateur
gh auth status   # doit confirmer que vous êtes identifié

  2. Récupérer le code

    Placez-vous là où vous voulez que le projet vive — dans l'exemple, le dossier personnel — puis clonez le dépôt. Cette commande télécharge tout le code et garde le lien avec GitHub, ce qui permettra de mettre à jour plus tard d'une seule ligne.

    Cloner le dépôt
    cd ~
git clone https://github.com/haikostudio/haikodev.git haikodev
cd haikodev

    Vous préférez une simple archive, sans lien avec GitHub ? Le bouton Code → Download ZIP sur la page du dépôt fait la même chose. Vous devrez alors la retélécharger à chaque mise à jour, ce qui est vite fastidieux.

  3. Installer les dépendances

    Le projet s'appuie sur des bibliothèques qu'il faut télécharger une fois. Attention à un piège classique : si votre serveur déclare déjà tourner « en production », l'installation saute les outils nécessaires à la construction et l'étape suivante échoue avec un tsc: not found. La commande ci-dessous force leur installation.

    Installer
    NODE_ENV=development npm install --include=dev

  4. Construire le programme

    Le code source est traduit en programme exécutable : les règles communes d'abord, puis le serveur, puis l'interface. Comptez une à deux minutes.

    Construire
    npm run build

  5. Créer votre identifiant

    L'accès au tableau est protégé par un identifiant et un mot de passe long. Un script les fabrique et les affiche une seule fois : notez-les immédiatement, ils ne se réaffichent pas.

    Créer l'accès
    node scripts/set-credentials.mjs

  6. Lancer une première fois, à la main

    Avant d'en faire un service permanent, vérifiez que tout démarre. Le programme écoute en local sur le port 7070 ; ouvrez http://127.0.0.1:7070 depuis la même machine (ou via un tunnel SSH depuis votre ordinateur) et connectez-vous avec l'identifiant de l'étape précédente.

    Démarrer
    npm start

    Vous voyez le mur de connexion, puis le tableau vide ? C'est gagné. Arrêtez le programme avec Ctrl+C : on va maintenant le rendre permanent.

  7. Le faire tourner en permanence

    Un fichier de service est fourni dans le dépôt. Il indique au système de démarrer HaikoDev au boot et de le relancer tout seul en cas de pépin.

    Installer le service
    sudo cp scripts/haikodev.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now haikodev
systemctl status haikodev   # doit afficher « active (running) »

  8. Lui donner une adresse

    HaikoDev n'écoute volontairement qu'en local : il n'est pas exposé à Internet tout seul. Pour y accéder depuis votre téléphone ou un autre ordinateur, mettez devant lui un serveur web qui s'occupe du nom de domaine et du certificat. Avec Caddy, trois lignes suffisent.

    /etc/caddy/Caddyfile
    haikodev.mondomaine.tld {
	reverse_proxy 127.0.0.1:7070
}

    Rechargez ensuite le serveur web, et l'adresse répond en HTTPS. C'est aussi cette adresse que vous pourrez « installer » comme une application sur votre téléphone.

  9. Brancher vos moteurs

    HaikoDev se sert des outils en ligne de commande déjà connectés sur la machine — il n'y a aucune clé à saisir dans l'interface, et donc rien qui se facture à l'appel. Installez et connectez le ou les moteurs que vous voulez utiliser sous le même compte que le service, puis choisissez le moteur par défaut dans les réglages du projet.

  10. Vérifier que tout va bien

    Le dépôt embarque ses propres contrôles. Le premier passe en revue les règles, les gabarits et la facturation ; le second ouvre un vrai navigateur et clique dans l'interface. Le troisième nettoie les cartes d'essai qu'ils ont créées : lancez-le toujours après, pour que le tableau reste celui de votre travail.

    Contrôler
    npm test
node scripts/verify-ui.mjs
node scripts/nettoyer-essais.mjs

Mettre à jour plus tard

Une nouvelle version est sortie ? Cinq lignes, toujours les mêmes, depuis le dossier du projet. Rien de ce que vous avez créé n'est effacé : vos projets, vos cartes et vos réglages vivent dans le dossier de données, à côté du code.

Mettre à jour
cd ~/haikodev
git pull
NODE_ENV=development npm install --include=dev
npm run build
sudo systemctl restart haikodev

Si quelque chose coince

Le service démarre puis s'arrête

Neuf fois sur dix, c'est un chemin ou un utilisateur qui ne correspond pas dans le fichier de service. Les journaux le disent en clair : journalctl -u haikodev -n 50.

La construction s'arrête sur « tsc: not found »

C'est le piège de l'étape 3 : les outils de construction n'ont pas été installés. Relancez l'installation avec NODE_ENV=development npm install --include=dev, puis npm run build.

GitHub refuse le clonage

Votre machine n'est pas identifiée, ou votre compte n'a pas encore accès au dépôt. gh auth status répond à la première question, et la page du dépôt dans un navigateur à la seconde.

Une fois le tableau en ligne, la suite est douce : créez un projet, décrivez votre premier besoin en français, et laissez le chef d'orchestre vous proposer une carte. C'est raconté en détail dans Votre première carte, de la demande à la mise en ligne.