メインコンテンツへスキップ

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.

プロジェクトとは、application.json ファイルを含むマシン上のディレクトリです。BRICKS CTORは単一ウィンドウで動作し、開いているすべてのプロジェクトをサイドバーに表示します。

プロジェクトを開く

  1. サイドバーのプロジェクトを開くボタンをクリックする
  2. BRICKSプロジェクトを含むディレクトリを選択する(または親ディレクトリ——アプリは最大3階層まで検索します)
  3. 検出されたプロジェクトがサイドバーにノードとして表示される
選択したディレクトリに application.json ファイルが含まれていない場合、アプリはエラーメッセージを表示します。閉じて別のディレクトリを試してください。

新しいプロジェクトを作成する

プロジェクトを作成する方法は2つあります:
  • メインチャットエージェントに依頼する(推奨)。 チャットを始めるで作りたいものを伝えると、エージェントが bricks app ctor-init を実行します。完了するとチャット下部に Created projects カードが表示されます——Start session をクリックすると、新しいプロジェクトがすでに選択された状態でプロジェクトスコープのチャットが開きます。メインチャットでのコンテキストは CONTEXT.md を介して引き継がれ、プロジェクトエージェントが続きから作業を始められます。
  • 「新しいプロジェクト」ダイアログを使う(手動)。 サイドバーの新しいプロジェクトをクリックして、エージェントを介さずフォームからプロジェクトをスキャフォールドします。
このセクションの残りでは手動フローを説明します。

新しいプロジェクトダイアログ

新しいプロジェクトダイアログには2つのタブがあります:既存から新規作成 複数の認証済みプロファイルがある場合、ダイアログ上部にプロファイルドロップダウンが表示され、任意のワークスペースでアプリを閲覧・作成できます。

既存のアプリから

既存からタブを使用して、BRICKS Controller に既に存在するアプリからローカルプロジェクトを作成します。
1

新しいプロジェクトダイアログを開く

サイドバーの新しいプロジェクトをクリックします。
2

アプリを選択する

ダイアログには選択したプロファイルのワークスペースのアプリが一覧表示されます。検索フィールドを使用して名前や説明でフィルタリングできます。
3

ディレクトリを選択する

アプリを選択し、プロジェクトを作成をクリックして、マシン上のディレクトリを選択します。アプリはそのディレクトリにプロジェクトを初期化します。

新しいアプリを作成する

新規作成タブを使用して、サーバーに新しいアプリを作成し、ローカルプロジェクトを一度に初期化します。
1

新しいプロジェクトダイアログを開く

サイドバーの新しいプロジェクトをクリックし、新規作成タブを選択します。
2

アプリの詳細を入力する

  • アプリ名(必須)——新しいアプリの名前
  • 説明(オプション)——アプリの機能についての簡単な説明
3

アプリとプロジェクトを作成する

アプリとプロジェクトを作成をクリックし、ディレクトリを選択します。BRICKSサーバーにアプリが作成され、ローカルプロジェクトが初期化されます。新しいセッションが自動的に開きます。

プロジェクトの管理

開いているプロジェクトはそれぞれサイドバーに展開可能なノードとして表示されます。プロジェクトをクリックすると展開され、セッションが表示されます。セッションはプロジェクトごとにスコープされています——プロジェクトを選択すると、そのチャットセッションのみが表示されます。

プロジェクトを削除する

サイドバーからプロジェクトを削除するには:
  1. プロジェクトにカーソルを合わせ、Xボタンをクリックする
  2. 表示された確認ボタンをクリックする(または3秒待つとリセットされます)
プロジェクトを削除しても、サイドバーから取り除かれるだけです。ディスク上のプロジェクトファイルは削除されません。

最近のプロジェクト

以前に開いたプロジェクトはクイックアクセス用に最近のプロジェクトリストに表示されます。アプリを再起動すると、開いているすべてのプロジェクトも復元されます。

プロジェクトコンテキストファイル

プロジェクトのルートに CLAUDE.md または AGENTS.md ファイルを配置すると、AI エージェントにカスタム指示を提供できます。これらのファイルはそのプロジェクトのすべてのセッションのエージェントシステムプロンプトに自動的に含まれます。 これは以下のような用途に役立ちます:
  • プロジェクト固有のコーディング規約の定義
  • プロジェクトアーキテクチャの説明
  • エージェントが従うべきカスタムルールの追加
アプリはプロジェクトルートの application.json も読み取り、エージェントのコンテキストにアプリのメタデータを含めます。

次のステップ

AIエージェントを使い始める

AIエージェントとチャットしてアプリケーションをビルドしましょう。

bricks-ctor SDK

bricks-ctorアプリケーションを動かすTypeScript SDKについて学びましょう。