Ray

Ray とは？

Ray は、コードからのデバッグ出力を収集・整理・可視化することを目的とした、言語・フレームワークを横断するデスクトップデバッグ支援ツールです。アプリケーションやコンソールにデータをインラインで出力する代わりに、Ray は文字列・配列・オブジェクト・クエリ・メール・イベントなどを送信・レンダリングできる中心的で機能豊富な環境を提供します。Ray を使うと、PHP・Laravel・JavaScript などのデバッグ情報を1つの専用アプリ内でフィルター・検索・アーカイブ・分析することができます。目的はシンプルです：ワークフローを崩さず、デバッグ体験を速く、整理された状態に保ちつつ、データを理解して活用するための強力なツールを提供すること。

Ray 3.0 は、伝統的なデバッグと AI 支援のワークフロー、HTML コンポーネント生成、よりリッチなダイアグラム表現を結びつける強化を導入します。製品は言語間の一貫性、IDE ナビゲーション用のインラインツール、リモート機能、柔軟なデータ可視化を強調し、チームや個人が導入しやすい設計になっています。

主な特徴

• 集中型デバッグサーフェス：すべてのデバッグ出力を1つのデスクトップアプリで収集・整理。端末やログに散らばりません。
• 多言語・多フレームワーク対応：PHP・Laravel・JavaScript などに対応。一貫した構文とワークフロー。
• SSH 経由のリモートデバッグ：リモートサーバーへ接続し、デバッグ出力を直接 Ray にストリーム。ローカルコードの変更なしでリアルタイム診断。
• メッセージのアーカイブと取得：重要な出力を保存して比較・監査・再現を可能にします。
• 実行の一時停止と計測：コードパスを一時停止し、呼び出し間の時間を測定。追加のコードを追加せずに性能ボトルネックを特定。
• ダンプ不要（自動出力）：クエリ・ジョブ・例外・他のデータソースから自動的に出力を受け取り、コードのボイラープレートを削減。
• IDE へのジャンプ：Ray から直接ソース場所を開く。複数の IDE をサポートし、素早いコンテキスト切替を実現。
• テーマと拡張性：ワークフローに合わせてテーマを変更、マクロを作成、サポート外の環境には独自クライアントや言語バインディングを追加して Ray を拡張。
• HTML コンポーネントと AI 連携出力：Ray 内で AI による HTML コンポーネントやプロトタイプを生成させ、直接操作可能。
• Mermaid と ERD 図：組み込みビューアで複雑なデータベーススキーマを説明する構造図を生成。
• MCP サーバー統合：AI エージェントが Windows 環境とツールへアクセスできるようにし、高度な自動化・生成タスクを支援。
• Ray 3.0 の新機能：AI が生成する内容を確認し、アプリ内で AI 出力と対話し、強化されたダイアグラム・可視化ツールを活用。
• クロスプラットフォーム対応：macOS・Windows・Linux で動作し、デバイス間で一貫したデバッグ体験を提供。
• ドキュメントとコミュニティ：Ray には包括的なドキュメントが付属し、コミュニティ主導の言語・フレームワークサポートのエコシステムがあります。

使い方の概要

1. Ray を手に入れる：公式サイトから Ray をダウンロードしてインストールします。ライセンスは Spatie を通じて管理され、標準とローンチセール価格を含む価格設定があります（Ray 3.0 時点、チェックアウトで価格を確認）。
2. インストールと初期化：開発機で Ray デスクトップアプリを起動します。Ray が動作中でデータ受信準備ができていることを確認します。
3. コードからデバッグデータを送る：ray() 関数（または言語にある同等のもの）を使って、文字列・配列・オブジェクト・クエリ・メール・イベントなど、検査したいデータを送信します。出力にラベルを付けてフィルタリング・検索性を向上させることができます。
4. アプリ内レンダリングを確認：Ray はデータを読みやすく、構造化された形式でレンダリングします。タイプ・出所・カスタムラベルでフィルターをかけ、全メッセージを横断して検索機能で特定します。
5. フィルタ・アーカイブ・洗練：出力に色やラベルを付け、後で参照するためにメッセージをアーカイブし、実行を一時停止・測定して問題を分離します。
6. IDE へジャンプ：ダンプ済みファイルからエディタの適切な場所へ直接ジャンプします。Ray は多くの人気 IDE をサポートしています。
7. AI と HTML コンポーネントを活用：Ray の AI 支援機能を使って HTML コンポーネントやプロトタイプを生成したり、Mermaid/ERD 図で複雑なデータを説明します。
8. 拡張とカスタマイズ：Ray がまだサポートしていない言語・フレームワークがある場合、マクロで拡張するか、データ送信用のカスタムクライアントを作成します。
9. 必要に応じてリモート展開：SSH 経由のリモートデバッグを活用して、リモートサーバー上で実行されているコードを監視・デバッグします。
10. 探索と最適化：一時停止・タイミング・フィルターを使い、パフォーマンス問題を特定し、再現し、複数の実行間で出力を比較します。

ユースケース

• PHP と Laravel のデバッグ：PHP と Laravel の実行時データを直接 Ray に出力し、配列・オブジェクトを可視化、クエリを文脈ラベル付きで検査します。
• JavaScript とフロントエンドのデバッグ：Node.js やブラウザベースのコードからのイベント・API 応答・コンソール風出力をひとつに集約します。
• リモートサーバーのデバッグ：SSH でリモートマシン上のコードをデバッグし、ログと出力を Ray にストリーミングします。
• AI 支援開発：AI を用いて HTML コンポーネント・プロトタイプ・複雑なスキーマの説明を生成し、Ray の内蔵ビューアで結果を可視化します。
• データベースとスキーマの可視化：データフローやクエリから Mermaid または ERD 図を作成し、データベースの関係をより理解します。
• デバッグのワークフローの一貫性：macOS・Windows・Linux 間で一貫したデバッグ体験を保ち、チームが環境に関係なく揃って作業できるようにします。

よくある質問

• 価格とライセンスモデルは？ Ray は有料のデスクトップライセンスを提供しています。最新リリース時点では結帳時に価格が表示され、ローンチセール価格が用意されている場合があります。ライセンスは通常一定期間（例: 1 年）有効で、公式のライセンスシステム（Spatie）で管理されます。生涯ライセンスはオプションとして言及されることがあり、現行の条件に準じます。主要バージョン前に購入したライセンスは、以前の条件のまま有効である場合があります。
• 対応プラットフォームは？ Ray はクロスプラットフォーム設計で、macOS・Windows・Linux に対応し、主要なデスクトップ環境で一貫したデバッグ体験を提供します。
• 対応言語とフレームワークは？ Ray は PHP・Laravel・JavaScript をサポートし、言語バインディングやカスタムクライアントを通じて他の言語もサポートします。対応言語間で一貫した構文とワークフローを重視しています。
• リモートデバッグは可能？ はい。SSH 経由のリモートデバッグをサポートしており、リモートサーバーへ接続して Ray にデバッグ出力を直接ストリームできます。
• 検索・フィルタ・アーカイブの使い方は？ タイプ・出所・カスタムラベルでメッセージをフィルタし、全メッセージを横断してアイテムを検索し、重要な出力を後で参照・比較するためにアーカイブします。大量のデバッグデータを効率的に管理できます。
• AI 統合と HTML 生成はある？ Ray 3.0 では AI が HTML コンポーネントやダイアグラムを生成でき、Mermaid および ERD 図の表示もサポートします。AI 出力をデバッグワークフローに組み込むことで洞察を深めることが可能です。
• 使い始め方は？ 公式サイトから Ray デスクトップアプリをダウンロードし、言語バインディングのドキュメントを確認して、コード内の ray() 呼び出しを介してデータを送信し始めてください。カスタマイズや拡張が必要な場合は、マクロやカスタムクライアントを検討してください。

追加ノート

Ray は、デバッグ出力をアプリケーションから分離しつつ、情報をアクセスしやすく、検索可能で、実用的に活用できるワークフローを強調します。目標は、強力で拡張性があり、クロスプラットフォームのデバッグ環境を提供し、プロジェクトとチームの成長に合わせてスケールしつつ、開発フローを保つことです。