get-bb/bb

bb – 自己構築型の「エージェント」IDE

概要 – bb は、デスクトップGUI、Web UI、コマンドラインインターフェース、またはHTTP APIから操作できるフルスタック開発環境です。自律型「エージェント」（スクリプト、ボット、AI駆動のヘルパー）がIDE自体を制御、カスタマイズ、自動化できるように設計されており、環境を一種の個人用ソフトウェア工場に変えます。

中核となるアイデア

• 自己構築 – IDEは自身の設定を変更し、プラグインをインストールし、実行中に新しいコードを生成することもできます。
• 複数のインターフェース – 同じ基盤システムが以下を通じて公開されています：
  • ネイティブデスクトップアプリ（Electronベース、macOS Appleシリコンで安定、Linux/Windowsはアルファ版）、
  • http://localhost:38886 でアクセス可能なWebアプリ、
  • bb CLI、および
  • RESTスタイルのHTTP API。
• スレッドベースの作業 – タスクは独立したスレッドで実行され、ライブで監視、介入、または別のエージェントに引き継ぐことができます。
• 拡張可能なプラグインモデル – プラグインは公開の bb-community マーケットプレイスに公開するか、ローカルパス、プライベートgitリポジトリ、またはnpmパッケージから読み込むことができます。

始め方

1. デスクトップアプリ – GitHubの desktop-latest タグから最新リリースをダウンロードします。macOS Appleシリコンが正式にサポートされています。LinuxおよびWindowsビルドは実験的です。
2. どこでも実行 – 単一のコマンドでローカルにサーバーを起動できます：

   npx bb-app@latest   # その後 http://localhost:38886 を開く
   

   （最新のプレリリースには @nightly を使用）。npm 12+では、ネイティブアドオンのインストールスクリプトを許可する必要があります。例：

   npx --allow-scripts=better-sqlite3,node-pty,@parcel/watcher bb-app@latest
   

3. CLIアクセス – 設定 → 一般 → コマンドラインパネルから bb コマンドを有効にし、ターミナルや他の自動化から bb … を使用してシステムを操作します。

開発ワークフロー

• pnpm dev – Viteベースのホットリロード対応フロントエンドを起動し、API/WebSocketトラフィックを別の開発サーバーにプロキシします。
• pnpm start – プロダクションスタイルのバンドルをビルドして実行します。
• 専門のスクリプト（pnpm dev:remote、pnpm start:worktree-remote など）を使用すると、信頼できるネットワーク（例：Tailscale経由）でUIとAPIを公開し、複数デバイスで使用できます。
• リポジトリはモノレポです。パッケージマップについては docs/repository-overview.md を参照してください。

テレメトリ

• プロダクション実行（デスクトップアプリ、npx bb-app、またはチェックアウトしたビルド）では、匿名の使用イベント（アプリ起動、スレッド作成数、メッセージ数、プラグインインストール）が送信されます。イベントには、バージョン、インストール方法、OS/CPU/Nodeの詳細、およびインストールごとのランダムな識別子が含まれます。プロジェクト名、ファイルパス、コミットハッシュ、メッセージ内容は送信されません。
• 開発実行（pnpm dev、pnpm start:worktree など）ではテレメトリは送信されません。
• テレメトリは BB_TELEMETRY=false で無効にできます。

現在のステータス

• コアアーキテクチャは安定していますが、UIサーフェス、ワークフロー、プラグインエコシステムはまだ進化中です（READMEにはプロジェクトが活発に開発中であると記載されています）。
• ネイティブアドオン（better-sqlite3、node-pty、@parcel/watcher）が必要です。最近のnpmバージョンではデフォルトでインストールスクリプトがブロックされるため、READMEに明示的な回避策が提供されています。

対象ユーザー

• スクリプトやAIエージェントによってプログラム的に操作できるIDEを求める開発者。
• ツール自体を生成、拡張、自動化できる「ソフトウェア工場」を構築するチーム。
• Node.js、npm、およびオプションのデスクトップアプリインストールに慣れたユーザー。

詳細情報

• システムとデータモデルの詳細： docs/system-overview.md
• ビジョンとロードマップ： docs/VISION.md
• 設定ガイド： docs/configuration.md
• コミュニティDiscord（README上部のバッジにリンクがあります）。

---

上記の情報はすべてリポジトリのREADMEから直接取得したものであり、追加の機能は推測されていません。