Intensif Gratuit 21–22/11Intensif gratuit de 2 jours en Vibecoding (21–22 nov, 16h00 MSK) · Cohorte 3 le 23/11S'inscrire gratuitement →Cohorte 3 (23/11)
SortieCode / SDK · Prêt à l'emploiHabr AI→ original

AcpGram permet de piloter Claude Code, Codex et Gemini CLI directement depuis Telegram

Claude Code, Codex et Gemini CLI sont des assistants IA pour développeurs qui ne fonctionnent que dans le terminal : on lance une tâche, puis on reste devant l'écran. AcpGram est un bot Telegram gratuit qui les exécute sur votre serveur et transforme leur travail en conversation. La progression de la tâche s'affiche dans un seul message, et chaque modification de fichier ou exécution de commande se valide d'un clic depuis votre smartphone. L'agent peut ainsi continuer à travailler pendant que vous êtes ailleurs.

Traité par IA depuis Habr AI ; édité par Hamidun News
AcpGram permet de piloter Claude Code, Codex et Gemini CLI directement depuis Telegram
Source : Habr AI. Collage: Hamidun News.
Écouter l'article
Fiche synthèse et chiffres clés
ParamètreDonnées
Source primaireHabr AI ↗
Rédacteur en chef
Chiffre clé #1Compatible avec Gemini CLI, Claude Code, Codex et Antigravity CLI
Quatre niveaux d'accès pour l'équipeRead, Normal, Full, Admin
Chiffre clé #3Node.js 24 sans dépendances npm, sessions dans SQLite, licence MIT

Claude Code, Codex, Gemini CLI et Antigravity CLI sont des agents IA destinés aux développeurs : ils lisent eux-mêmes le dépôt, modifient des fichiers et exécutent des commandes. Tous fonctionnent dans le terminal, ce qui est peu pratique. On lance une tâche, puis soit on reste devant l'écran, soit on s'absente sans savoir si l'agent n'est pas bloqué sur la question « puis-je exécuter cette commande ?

». Le développeur qui se fait appeler selesnow a publié AcpGram, une passerelle open source qui déplace le pilotage de ces agents vers Telegram. L'agent continue de tourner sur votre serveur domestique ou professionnel, et vous le suivez et cliquez sur des boutons dans une conversation depuis votre smartphone.

Le nom vient du protocole ACP (Agent Client Protocol), sur lequel repose l'ensemble.

Fonctionnement : un seul protocole au lieu de quatre interfaces

ACP est un mode d'échange de messages entre un programme et un agent, au format JSON-RPC, via les flux standard d'entrée-sortie. AcpGram lance l'agent en ligne de commande comme sous-processus sur votre machine, communique avec lui selon ce protocole et affiche vers l'extérieur une interface de chat familière.

Quatre moteurs sont pris en charge. Gemini CLI (gemini --acp) et Antigravity CLI (agy acp) comprennent ACP nativement. Pour Claude Code et OpenAI Codex, l'auteur utilise des ponts ACP légers distincts, claude-agent-acp et codex-acp. Pour l'utilisateur, la différence est masquée : le changement de projets, de sessions et l'attribution des autorisations fonctionnent de la même manière, et on change de moteur avec la commande /engine. Le modèle et le niveau de raisonnement se choisissent via /model, et le choix est mémorisé séparément pour chaque utilisateur et chaque moteur.

Le projet lui-même est écrit en Node.js 24 pur, sans aucune dépendance npm, et fonctionne sous Windows, Linux et macOS. Sur le plan technique, c'est un avantage : la chaîne d'approvisionnement à vérifier est plus courte, et le risque qu'un service accédant à votre code casse à cause d'une mise à jour tierce est réduit.

Ce qui s'affiche dans le chat et comment contrôler l'agent

Pendant l'exécution, les réponses de l'agent, ses « réflexions » et la liste des étapes (lecture de fichiers, exécution de commandes, recherches, modifications) se mettent à jour dans un seul brouillon de message, et non dans des dizaines de répliques distinctes. La durée d'exécution y figure également. Si l'agent tourne en boucle, la commande /stop l'arrête.

Une fois la tâche terminée, un rapport structuré arrive, avec titres, listes, tableaux et coloration syntaxique du code. Sous ce rapport se trouve un journal des étapes repliable. Le pied de message indique le moteur, le modèle, le niveau de raisonnement, les tokens et le temps, et pour Claude Code, le coût réel de la requête. Pour ceux qui suivent leurs dépenses en tokens, c'est un détail utile : on voit directement dans la conversation ce qu'a coûté une tâche donnée.

Lorsque l'agent veut modifier un fichier ou exécuter un script shell, le bot envoie des boutons inline : « Autoriser », « Autoriser pour cette session » ou « Refuser ». D'après l'auteur, le système écarte les options qui élèveraient la session au-delà des droits de l'utilisateur courant.

Un mode multi-utilisateur est prévu pour les équipes. On invite des collègues par liens à usage unique (/invite), et l'administrateur définit le niveau d'accès : Read, Normal, Full ou Admin. Il attribue aussi les moteurs et modèles autorisés et consulte les utilisateurs actifs (/users, /active). Les niveaux modulent l'autonomie de l'agent, de l'analyse de code en lecture seule jusqu'à l'application automatique des modifications sans confirmation. Les sessions, requêtes, appels d'outils et tokens sont enregistrés dans une base SQLite intégrée (node:sqlite), si bien que l'historique peut être rappelé via /sessions même après un redémarrage du bot. Effet secondaire : on dispose d'un journal d'audit prêt à l'emploi.

Installation et limites

L'installation se fait par une seule commande. Sous Windows, il s'agit du script PowerShell install.ps1, sous Linux et macOS de install.sh. D'après l'auteur, le programme d'installation vérifie les sommes de contrôle et, si nécessaire, télécharge un binaire Node.js 24 isolé, sans droits administrateur. Il ajoute ensuite acpgram au PATH et lance l'assistant acpgram setup, qui vérifie le jeton du bot, reprend votre identifiant Telegram comme administrateur et vous aide à renseigner les clés API.

Pour que le bot survive aux redémarrages, on l'installe comme service via npm run service:install : NSSM sous Windows, systemd --user sous Linux, launchd sous macOS. Une variante avec Docker Compose existe également. Les agents n'y voient que le dossier de projets monté (PROJECTS_DIR), tandis que les sessions et les réglages sont conservés dans des volumes persistants. Si vous autorisez l'agent à exécuter des commandes sur le serveur, le conteneur limite les dégâts possibles.

Des réserves s'imposent. Il s'agit d'un projet personnel d'un seul auteur, qui, selon ses dires, est devenu un outil « tout à fait mûr ». Le matériau ne contient ni retours indépendants ni audit de sécurité. Le bot accède à votre code et à votre interpréteur de commandes : les niveaux Full et Admin doivent donc être attribués avec prudence. Le jeton du bot et l'identifiant de l'administrateur gagnent à être traités comme des secrets. Par ailleurs, chaque moteur exige sa propre authentification : clé Gemini, clé Anthropic ou abonnement, connexion par compte Google pour Antigravity, jeton pour Codex. Les jetons et abonnements restent de votre côté.

Conclusion pratique : si vous faites déjà tourner des agents sur une machine dédiée ou un VPS, AcpGram vous évite de garder un terminal ouvert et de manquer les demandes de confirmation. Le code est publié sous licence MIT, il peut donc être lu, vérifié et adapté à votre équipe.

Dossier

Questions clés sur cet article

Que sait-on sur Fonctionnement : un seul protocole au lieu de quatre interfaces ?

ACP est un mode d'échange de messages entre un programme et un agent, au format JSON-RPC, via les flux standard d'entrée-sortie. AcpGram lance l'agent en ligne de commande comme sous-processus sur votre machine, communique avec lui selon ce protocole et affiche vers l'extérieur une interface de chat familière. Quatre moteurs sont pris en charge. Gemini CLI (gemini --acp) et Antigravity CLI (agy acp) comprennent ACP nativement.

Que sait-on sur Ce qui s'affiche dans le chat et comment contrôler l'agent ?

Pendant l'exécution, les réponses de l'agent, ses « réflexions » et la liste des étapes (lecture de fichiers, exécution de commandes, recherches, modifications) se mettent à jour dans un seul brouillon de message, et non dans des dizaines de répliques distinctes. La durée d'exécution y figure également. Si l'agent tourne en boucle, la commande /stop l'arrête. Une fois la tâche terminée, un rapport structuré arrive, avec titres, listes, tableaux et coloration syntaxique du code.

Que sait-on sur Installation et limites ?

L'installation se fait par une seule commande. Sous Windows, il s'agit du script PowerShell install.ps1, sous Linux et macOS de install.sh. D'après l'auteur, le programme d'installation vérifie les sommes de contrôle et, si nécessaire, télécharge un binaire Node.js 24 isolé, sans droits administrateur. Il ajoute ensuite acpgram au PATH et lance l'assistant acpgram setup, qui vérifie le jeton du bot, reprend votre identifiant Telegram comme administrateur et vous aide à renseigner les clés API.

ZK
Zhemal Khamidun — CPO d'Alpina Digital, product manager d'AlpinaGPT. Conçoit des produits IA depuis 2019. Hamidun News est un projet personnel devenu un agrégateur en production avec plus de 6 000 lecteurs.
✦ Hands-On AI Engineering · Hamidun Academy

Build & Ship Production AI Agents Without Boilerplate Code

Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.

Start 72h Free Trial →Vibe-Coding Intensive
Qu'en pensez-vous ?
Chargement des commentaires…