Level Sony M.
Back to Projects

readme-runner — Lancer n'importe quel projet en une commande

Outil CLI en Go qui lit le README d'un projet, génère un plan d'exécution via IA et le lance automatiquement — aucune configuration manuelle requise.

Go CLI LLM IA DevOps OpenSource
Share
Code Article Star
readme-runner — Lancer n'importe quel projet en une commande
Table des matières

Why

Chaque fois qu'on clone un projet pour le tester, on perd du temps à déchiffrer le README, trouver les bonnes versions, et deviner les commandes à lancer. Si un humain peut lire le README et comprendre comment démarrer l'app, un LLM peut en faire autant — et générer un plan fiable en quelques secondes.

What

readme-runner (rdr) est un outil CLI en Go qui clone, installe et lance n'importe quel projet depuis une seule commande. Il lit le README, calcule un score de clarté, génère un RunPlan structuré via un LLM, le valide via une couche sécurité, puis exécute — ou prévisualise — chaque étape.

How

Pipeline modulaire en Go : fetcher (clone/copie), scanner (détection de stack + parsing README), provider LLM (Anthropic, OpenAI, Mistral, Ollama), validateur (blocklist sécurité, niveaux de risque), vérificateur de prérequis, exécuteur (dry-run par défaut), et nettoyage. Développé avec GitHub Copilot CLI.

Présentation

readme-runner (rdr) est un CLI Go qui transforme le README.md d’un projet en plan d’installation exécutable — propulsé par un LLM. Une seule commande pour cloner, configurer et lancer.

Développé dans le cadre du GitHub Copilot CLI Challenge (DEV Community × GitHub, 2026).

État du projet

En développement actif — première version non encore publiée. Le pipeline principal est fonctionnel ; les travaux en cours portent sur le support multi-OS et le cache de plans.

Lire l’article complet →

Technologies & Tools

Go
GitHub Actions
GitHub
Linux
Bash
Docker
Git
Go
GitHub Actions
GitHub
Linux
Bash
Docker
Git

Projet suivant

VolleyxX— Conception et réalisation d’une application mobile de gestion et de notation de matchs de volley-ball

Commentaires