Forge : harness de codage IA indépendant des modèles et CLI, guide de décision avant la première prise en main

À qui s'adresse Forge

• Forge s'adresse aux développeurs qui veulent accomplir leurs tâches de codage dans le terminal avec un CLI/TUI natif, et qui souhaitent que chaque tâche soit automatiquement routée vers le modèle offrant le meilleur compromis « coût × capacités ». Il s'agit d'un harness de codage IA indépendant des modèles, écrit en Rust : un seul binaire natif, sans besoin de runtime Node, Python ou Bun.
• Si vous préférez l'utiliser via une application de bureau, une application compagnon iOS/Android/Web ou une API locale compatible OpenAI, la documentation officielle indique que ces formes sont également proposées.
• Cas où ce n'est pas adapté : si vous avez besoin d'un mode d'installation autre qu'un assistant de configuration graphique, ou si vous dépendez d'un écosystème spécifique de plugins/extensions, les preuves ne fournissent pas ces détails et il est impossible de le confirmer ; quant aux agents spécifiques pris en charge et aux environnements linguistiques supportés, la documentation officielle n'en dit rien : c'est inconnu, ne faites pas d'hypothèses de votre côté.
• Prérequis d'utilisation : des identifiants de modèle accessibles. forge setup vous guide pour connecter les modèles, configurer la sécurité et les coûts, la recherche, l'importation et les services en arrière-plan ; les clés API sont stockées dans le trousseau du système d'exploitation (OS keyring).

Première tentative en 3 minutes

Il n'existe qu'un seul chemin principal recommandé : le script d'installation shell officiel en une ligne.

1. Prérequis : un terminal capable d'exécuter des commandes shell, avec accès à GitHub.
2. Exécutez dans le terminal :

curl -fsSL https://raw.githubusercontent.com/Adulari/forge/main/install.sh | sh

Ce script télécharge le binaire de release correspondant et l'installe dans ~/.local/bin.

1. Point de contrôle des effets secondaires : l'installation interactive installe par défaut aussi l'application de bureau Forge. Si vous n'en avez pas besoin, répondez n à l'invite (ou définissez FORGE_DESKTOP=0 pour l'ignorer). Il s'agit d'une installation par exécution d'un script distant via un pipe : vérifiez vous-même la source de confiance avant de l'exécuter.
2. Après l'installation, lancez forge : au premier démarrage, le processus guidé forge setup s'ouvre automatiquement ; suivez les invites pour connecter les modèles ainsi que les réglages de sécurité et de coûts.
3. Pour la première tâche, choisissez de préférence une tâche d'analyse à faible risque, par exemple lui demander d'expliquer un passage de code ou de résumer la structure du projet dans le dépôt courant. Signal de succès observable : la tâche est distribuée et la réponse/l'analyse du modèle s'affiche dans l'interface du terminal. Quant à savoir si ce processus lit ou écrit vos fichiers, exécute des commandes ou accède au réseau, les preuves ne le précisent pas : avant toute tâche modifiant des éléments, vérifiez par vous-même et gardez le contrôle aux points de confirmation.

Autres méthodes (mention secondaire uniquement) : dans un dépôt cloné, les hooks, serveurs MCP, règles temper et allow contenus dans .forge/ restent inactifs tant que forge trust n'a pas été exécuté.

Cas d'usage

Cas 1 : comprendre rapidement un dépôt inconnu à faible coût. Situation : vous reprenez un projet de code qui ne vous est pas familier. Méthode : lancez l'interface terminal de forge dans le répertoire du dépôt et lancez une tâche d'analyse en lecture seule, par exemple « résume la structure de ce projet et ses points d'entrée ». Selon son mécanisme de routage, la tâche est confiée au modèle approprié et vous voyez le résultat directement dans le TUI. Résultat attendu : un aperçu du projet ; c'est une tâche d'analyse, qui ne modifie aucun fichier.

Cas 2 : exécution ponctuelle (headless) d'une requête de codage unique. Situation : vous scriptez ou ne voulez pas passer par l'interface interactive. Méthode : appelez forge en mode one-shot/headless via le CLI et soumettez une tâche de codage clairement définie (les preuves ne donnent pas le format exact des arguments de ligne de commande ; on peut seulement confirmer que cette forme existe). Résultat attendu : la tâche est routée vers le modèle optimal selon le compromis coût × capacités et la sortie est renvoyée. Pour les tâches de codage impliquant des modifications de fichiers ou l'exécution de commandes, définissez clairement le périmètre des changements avant de les soumettre : les preuves ne précisent pas les effets secondaires, un contrôle au niveau de l'environnement est nécessaire de votre part.

Limites d'utilisation

• Effets secondaires de l'installation : le script d'installation en une ligne installe par défaut aussi l'application de bureau (réponse interactive par défaut : yes) ; refusez avec n ou FORGE_DESKTOP=0.
• Périmètre de confiance au niveau du dépôt : dans un dépôt cloné, les hooks .forge/, serveurs MCP, règles temper/allow sont inactifs par défaut et ne prennent effet qu'après un forge trust explicite — c'est un point de contrôle de sécurité officiellement explicite.
• Environnement d'exécution : un seul binaire Rust natif, sans dépendance à Node/Python/Bun/Electron. Les clés API sont stockées dans le trousseau du système d'exploitation.
• Au-delà des limites officiellement énoncées, les informations suivantes ne sont pas fournies par les preuves et restent inconnues : quels clients agents spécifiques sont pris en charge, quelles langues naturelles et quels langages de programmation sont couverts, et si les opérations de revue ou de diagnostic lisent/écrivent des fichiers, exécutent des commandes ou accèdent au réseau. Ne considérez pas l'inconnu comme « sans risque » ; pour toute tâche modifiant des fichiers, exécutant des commandes ou appelant des services externes, vérifiez d'abord les effets secondaires avant de l'exécuter.