Développer
Architecture
| Fichier | Rôle |
|---|---|
server.py | serveur HTTP, bibliothèque standard Python seulement |
index.html | page unique : interface, styles et scripts |
static/ | favicon, logos et polices Quatrecenttrois |
install.sh | installation, vérification, mise à jour, désinstallation |
tests/ | tests de bout en bout, faux claude, gh et tailscale |
docusaurus/ | cette documentation |
Le serveur lance claude remote-control dans un pseudo-terminal, lit sa sortie pour en extraire l'adresse de la session, et appelle gh, git et claude pour le reste. Les transcriptions sont lues dans ~/.claude/projects.
Tests
python3 -m unittest discover -s tests -v
Aucune dépendance : bibliothèque standard Python, git, et Chrome ou Chromium pour l'interface.
| Fichier | Ce qu'il couvre |
|---|---|
tests/test_api.py | un vrai serveur dans un répertoire personnel temporaire, avec une organisation GitHub simulée par des dépôts git nus : jeton, sessions, reprise, confiance du dossier, dépôts, branches, fetch et pull, plugins, catalogue, MCP, HTTPS, noms d'hôte |
tests/test_ui.py | l'interface dans Chrome, par son protocole de débogage, avec de vrais clics et gestes tactiles |
tests/test_install.py | install.sh : aide, liens, QR code, questions dans un vrai terminal |
Sans Chrome, les tests d'interface sont ignorés, sauf avec REQUIRE_CHROME=1.
Intégration continue
À chaque push, GitHub Actions vérifie la syntaxe, passe shellcheck sur install.sh, lance tous les tests sous Python 3.10 et 3.13, puis construit cette documentation et son image Docker.
Captures de la documentation
python3 tests/captures.py
Le script lance l'environnement de démonstration et enregistre les captures dans docusaurus/static/img/captures/, sur téléphone et ordinateur, en thème Clair et Forêt.