À propos du projet

Releases CLI est le client en ligne de commande pour releases.sh, un registre hébergé qui indexe les notes de version, les journaux de modifications et les annonces de produits collectés depuis GitHub, les flux RSS/Atom/JSON et les pages de journal de modifications des produits. Ce dépôt ne contient que le CLI ; le worker API, le serveur MCP, le frontend web et le pipeline d'ingestion résident dans un dépôt backend séparé. La recherche et la navigation fonctionnent sans compte ni configuration, car le CLI communique avec l'API hébergée. La connexion débloque des fonctionnalités personnelles : suivre des organisations et produits, un flux de versions personnalisé et des webhooks sortants. La connexion utilise le flux d'autorisation d'appareil OAuth 2.0, approuvant un code court dans un navigateur connecté ; seule une clé API en lecture seule est stockée localement (dans ~/.releases/credentials avec des permissions 0600), jamais la session du navigateur. L'accès en écriture et administrateur est décrit comme une bêta fermée séparée. Les options d'installation incluent Homebrew, npm (installation globale ou npx), un installateur shell et des binaires précompilés signés publiés avec des sommes de contrôle pour les installations hors ligne ou épinglées. Les complétions shell sont installées automatiquement par Homebrew et peuvent être activées ailleurs avec une commande de complétion. Les commandes principales couvrent la recherche de versions (éventuellement limitées par date de publication avec des raccourcis relatifs comme 90d ou 4w), le suivi des dernières versions d'un produit, la liste par catégorie, la récupération d'une organisation, d'un produit ou d'une source, l'affichage d'un aperçu d'organisation généré par IA, les statistiques du registre, le journal de modifications du projet lui-même et la soumission d'une URL source ou de commentaires. Les identifiants sont interchangeables : les slugs, les ID typés ou les coordonnées org/slug fonctionnent tous, et les ID sont stables lors des renommages. Les commandes de lecture acceptent un indicateur JSON, les commandes de liste émettant une enveloppe éléments/pagination et les lecteurs de versions offrant une forme par défaut allégée ou une charge utile complète. Les commandes de suivi et de flux gèrent une chronologie personnelle des organisations et produits suivis. Les commandes de webhook enregistrent des POSTs release.created signés, soit limités à une organisation (jusqu'à dix, avec des filtres optionnels de source, produit et type), soit au graphe de suivi actuel (un webhook). Les clés de signature sont affichées une seule fois à la création ou rotation, et une commande de vérification contrôle les signatures localement. Les webhooks peuvent également être gérés dans un espace de travail partagé, où seuls les propriétaires et administrateurs peuvent créer, modifier, faire pivoter ou supprimer, tandis que tout membre peut lister, voir et tester. Les commandes de contribution ne nécessitent pas de compte : soumettre une URL de journal de modifications, envoyer des commentaires sur des bogues ou idées, et valider un manifeste releases.json v2 par rapport au schéma publié hors ligne. La soumission et les commentaires prennent en charge les invites interactives, l'entrée stdin et les aperçus JSON à sec. Pour les agents IA, le projet pointe vers un serveur MCP hébergé accessible via mcp-remote, et le dépôt sert également de plugin de marché Claude Code fournissant des outils MCP hébergés, une commande de recherche et des compétences à déclenchement automatique. Une commande d'installation de compétences ajoute également les compétences à d'autres outils d'agent. Les variables d'environnement permettent de remplacer la clé API et l'URL de base de l'API, et de désactiver la télémétrie anonyme. Pour les proxys interceptant TLS, le binaire compilé honore les variables de certificat CA standard Node/OpenSSL. Les codes de sortie documentés distinguent le succès, les erreurs d'application, les erreurs d'utilisation ou de fournisseur et l'annulation. Le projet est sous licence MIT.