cli

# Opaline CLI Opaline CLIは、Claude CodeおよびOpenAI Codexのセッションを取得し、チーム分析のためにOpalineプラットフォームへアップロードするコマンドラインツールです。本番APIは`https://opaline.so`でホストされています。以前は`rudel`として知られており、その名前との互換性を維持しています。 ## クイックスタート Node.js 20以降が必要です。任意のディレクトリから`npx opaline@latest`を実行してください。CLIはローカルのClaude CodeおよびCodexセッションをスキャンし、リポジトリとセッションの数を表示し、アップロードして同期を続けるリポジトリを選択できます。ログインは選択後にのみ開きます。`pnpx opaline@latest`も機能します。グローバルインストールは任意です。 Opalineデモからコマンドをコピーすると、隠し`--code`値が追加されます。このワンタイムコードは、ライブ選択とアップロードステータスのためにターミナルをブラウザとペアリングします。未使用の場合、10分で期限切れになります。コマンドをコピーした同じブラウザでログインを承認してください。初回のアップロードはブラウザ設定を続行します。戻ってきたユーザーはワークスペースのセッションページを開きます。 自動アップロードは、バンドルされたCLIを`~/.rudel/runtime`に保持し、Node実行可能ファイルを使用するため、一時的なランナーキャッシュがなくなった後もフックは機能し続けます。 `opaline login`はブラウザベースのデバイスフローを開きます。`opaline upload`はローカルのワークツリーをリポジトリごとにグループ化し、同期を維持するリポジトリを選択させ、必要なClaude Codeおよび/またはCodexフックをインストールし、新しいセッションをアップロードします。同じテーブルを開いてリポジトリをON/OFFに切り替えます。 既存の`rudel`ユーザーは再度ログインする必要はありません。Opalineは意図的に既存の`~/.rudel`認証情報と状態ディレクトリを読み取り、`rudel`パッケージは互換性エイリアスとして継続します。 ホームフォルダを含む任意のディレクトリから`opaline upload`を実行してください。ピッカーはリポジトリ全体で保存されたセッションを見つけ、選択したリポジトリをアップロードします。また、それらの選択に対して自動アップロードを有効にします。Claude Codeのフックはユーザー設定にインストールされるため、セットアップは現在のディレクトリに依存しません。既存のフックと設定は保持されます。 ## 典型的なワークフロー `opaline upload`（または`npx opaline@latest`）を実行してリポジトリテーブルを開きます。テーブルはスキャン中に埋まり、ローカルおよび既にアップロードされたセッション数がON/OFFトグルとともに表示されます。スペースでリポジトリを変更します。Enterで新しく追加された、既にアクティブな、および非アクティブ化されたリポジトリを含むレビューを開きます。Enterで確認します。Escで編集に戻ります。アップロードの進行状況は同じテーブルに表示されます。 既存のRudelフックは有効として認識されます。保存すると、所有フックがOpalineに移行され、重複するローカルフックが削除され、無関係なエージェント設定が保持されます。 Codex通知ツールは自動アップロードと共存できます。Opalineは既存のコマンドと引数を保持し、通知JSONを転送し、独立してアップロードします。Codex Computer Useは通知チェーンの先頭に留まります。アップロードをOFFにしても通知は機能し続けます。カスタムスクリプトは保持されます。Opalineは、古いRudelインストールを自身で呼び出すスクリプトを書き換えません。セットアップの失敗は、完全な詳細と再試行/戻るアクションを表示します。Codex設定が無効な場合に修正する設定ファイルも含まれます。 ## 主要な概念 - **セッション:** ローカルマシンで検出されたClaude CodeおよびCodexのJSONLトランスクリプト。 - **フック:** `opaline upload`または`opaline enable`によってインストールされるエージェントライフサイクルコマンド。フックはヘッドレスで実行され、リポジトリ許可リストを参照し、既知のシークレットパターンをフィルタリングし、完了したセッションをアップロードします。 - **組織:** アップロードを受け取るOpalineワークスペース。`opaline set-org`を使用して、プロジェクトに関連付けられた組織を変更します。 - **ローカル状態:** 認証情報、再試行キュー、ログ、プロジェクトマッピングは、互換性のために`~/.rudel`に残ります。`OPALINE_CONFIG_DIR`を設定して別のディレクトリを選択します。`RUDEL_CONFIG_DIR`は引き続きサポートされます。 - **互換性エイリアス:** `rudel`実行可能ファイルは、引数、標準入出力、終了ステータスを変更せずに同じOpaline実装に委任します。唯一の追加は、呼び出しごとにstderrへの名前変更通知が1つあることです。