このプロジェクトについて
Releases CLIは、GitHub、RSS/Atom/JSONフィード、製品の変更履歴ページから収集したリリースノート、変更履歴、製品発表をインデックス化するホスト型レジストリreleases.shのコマンドラインクライアントです。このリポジトリにはCLIのみが含まれており、APIワーカー、MCPサーバー、Webフロントエンド、取り込みパイプラインは別のバックエンドリポジトリにあります。
CLIはホスト型APIと通信するため、検索と閲覧はアカウントや設定なしで利用できます。サインインすると、組織や製品のフォロー、パーソナライズされたリリースフィード、送信Webhookといった個人向け機能が利用可能になります。ログインにはOAuth 2.0 Device Authorization Grantを使用し、サインイン済みブラウザで短いコードを承認します。ローカルに保存されるのは読み取り専用のAPIキーのみで(~/.releases/credentialsに0600権限で保存)、ブラウザセッションは保存されません。書き込みおよび管理者アクセスは別のクローズドベータとして説明されています。
インストール方法には、Homebrew、npm(グローバルインストールまたはnpx)、シェルインストーラー、およびエアギャップ環境や固定バージョンインストール向けにチェックサム付きで公開された署名済みのプリコンパイル済みバイナリがあります。シェル補完はHomebrewによって自動的にインストールされ、それ以外の環境ではcompletionコマンドで有効化できます。
主要なコマンドは、リリースの検索(90dや4wなどの相対的な省略形で公開日を指定可能)、製品の最新リリースの追跡、カテゴリ別の一覧表示、組織・製品・ソースの取得、AI生成の組織概要の表示、レジストリ統計、プロジェクト自身の変更履歴、ソースURLやフィードバックの送信をカバーします。識別子は相互に交換可能で、スラッグ、型付きID、org/slug座標のいずれも機能し、IDは名前変更後も安定しています。リーダーコマンドはJSONフラグを受け付け、リストコマンドはitems/paginationエンベロープを出力し、リリーズリーダーはスリムなデフォルト形状または完全なペイロードを提供します。
followおよびfeedコマンドは、フォロー中の組織と製品の個人的なタイムラインを管理します。Webhookコマンドは署名付きのrelease.created POSTを登録し、組織単位(最大10件、ソース、製品、タイプのフィルターを任意で指定可能)または現在のフォローグラフ単位(Webhook 1件)でスコープを設定できます。署名キーは作成時またはローテーション時に一度だけ表示され、verifyコマンドでローカルに署名を検証できます。Webhookは共有ワークスペースでも管理でき、作成、編集、ローテーション、削除はオーナーと管理者のみが実行できますが、一覧表示、閲覧、テストは任意のメンバーが実行できます。
コントリビューションコマンドはアカウント不要です。変更履歴URLの送信、バグやアイデアのフィードバック送信、公開スキーマに対するreleases.json v2マニフェストのオフライン検証が可能です。submitとfeedbackはどちらも対話型プロンプト、stdin入力、ドライランJSONプレビューをサポートしています。
AIエージェント向けに、このプロジェクトはmcp-remote経由でアクセス可能なホスト型MCPサーバーを提供しており、このリポジトリはClaude Codeマーケットプレイスプラグインとしても機能し、ホスト型MCPツール、lookupコマンド、自動トリガースキルを提供します。skills installコマンドは、他のエージェントツールにもスキルを追加します。
環境変数により、APIキーとAPIベースURLの上書き、および匿名テレメトリの無効化が可能です。TLS傍受プロキシの場合、コンパイル済みバイナリは標準のNode/OpenSSL CA証明書変数を尊重します。文書化された終了コードは、成功、アプリケーションエラー、使用法またはプロバイダーエラー、キャンセルを区別します。このプロジェクトはMITライセンスです。
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.