> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# ファイルビューア

> タブ式の右パネルでプロジェクトファイルを閲覧、プレビュー、検索する

チャットの横にあるタブ式ビューアで、プロジェクトファイル、設定アセット、チャットで参照されたパスを開きます。ファイルビューアはソースコード、Markdown、画像、アニメーションをインラインで描画し、プロジェクト全体を検索し、必要に応じてファイルを外部エディタで開きます。

## ファイルビューアを開く

ファイルを開く方法は 3 つあります：

* **右パネルから** — 右パネルを開き、開始ページで **ファイル** を選択してファイルツリーを参照します。
* **ツール項目から** — エージェントがファイルを読み取り、書き込み、または編集すると、チャット内のパスの横にファイルアイコンが表示されます。クリックすると、そのファイルがビューアタブで開きます。
* **チャットメッセージから** — メッセージ内のローカルファイルリンク（例：`[README](README.md)` のような Markdown リンク）をクリックすると、タブで開きます。

## ファイルツリー

ファイルビューはプロジェクトをツリー形式で 2 つのセクションに分けて表示します：

* **Local files** — プロジェクトディレクトリ内のファイルとフォルダ。フォルダをクリックすると展開または折りたたみ、ファイルをクリックするとタブで開きます。
* **Config URL assets** — ビルド済みアプリケーション設定が参照するリモートアセット（画像、Lottie、Rive のソース）を Subspace ごとにグループ化したものです。各項目には `md5` が表示され、設定と照合できます。

トグルボタンをクリックすると、ツリーペインの表示・非表示を切り替えられます。依存関係、ビルド、ツールのフォルダはツリーから除外されます（`node_modules`、`.git`、`.github`、`.claude`、`.codex`、`.husky`、`dist`、`.cache`、`bun.lock`）。ただし `.bricks/build` は常に含まれます。

## タブ

開いた各ファイルはビューア上部のタブになります。すでに開いているファイルを再度開くと、重複させずに既存のタブに切り替わります。タブは並べ替えや終了が可能です。

## ファイルタイプ別のプレビュー

ビューアはファイルに応じて描画方法を選択します：

| ファイルタイプ                                  | 描画                                                            |
| ---------------------------------------- | ------------------------------------------------------------- |
| ソースコード、JSON、テキスト、dotfile、TOML、YAML、shell | 行番号付き、シンタックスハイライト付きのコード                                       |
| Markdown                                 | **Preview** / **Source** トグル付きの描画プレビュー。Mermaid 図と埋め込み画像を描画します |
| 画像と SVG                                  | インライン画像                                                       |
| 動画                                       | インラインプレーヤー                                                    |
| Lottie（`.lottie` または Lottie JSON）        | アニメーションプレビュー                                                  |
| Rive（`.riv`）                             | アニメーションプレビュー                                                  |

サイズ上限（テキストは 1 MB、バイナリは 10 MB）を超えるファイルは **File is too large to preview.** と表示され、代わりに外部で開くボタンが表示されます。

## ファイル内を検索

ビューアにフォーカスがある状態で **Cmd+F**（macOS）または **Ctrl+F**（Windows と Linux）を押すと、検索バーが開きます。現在の一致位置と総数（例：`1/1`）を表示し、ファイル内のすべての一致箇所をハイライトします。**Enter** で次の一致箇所に移動し、**Esc** または閉じるボタンで検索バーを閉じます。

## ファイルをまたいで検索

ツリー上部の **Search files** ボックスに入力すると、プロジェクト全体でファイル内容を検索できます。一致したファイルは **Content matches** の下に表示されます。結果をクリックするとファイルが開きます。検索結果は最大 200 件まで返されます。

## 外部で開く

ビューアのヘッダーにある **外部でファイルを開く** をクリックすると、現在のファイルを外部エディタで開きます。ボタンにはシステムで検出されたエディタが一覧表示されます。