BoltLynx ドキュメント

ローカルクライアントを導入して、作業を始める。

Web アプリでエージェントと対話し、作業を管理します。ローカルクライアントは、許可された操作をあなたのマシン上で実行します。

ポータブル版デスクトップランチャーをダウンロードし、ZIP 内のすべてのファイルを C:\BoltLynx などの常設フォルダーに展開してから、そのフォルダー内で起動します:

Windows ランチャーをダウンロード

curl -fsSL https://boltlynx.com/install.sh | bash
boltlynx start
boltlynx status
curl -fsSL https://boltlynx.com/install.sh | bash
boltlynx start
boltlynx status

クイックスタート

エージェントが操作を行うマシンまたは分離環境を設定します。1 つのローカルクライアントで複数のエージェントを利用できます。

  1. ローカルクライアントをインストールします。
  2. ローカルクライアントを起動し、ブラウザでペアリングページを確認します。
  3. Web アプリを開き、エージェントを作成または選択します。
  4. エージェントに使用を許可するプロジェクトフォルダを選びます。

Windows 用ローカルクライアント

Windows ランチャーをダウンロードします:

Windows ランチャーをダウンロード

今後も保持する常設フォルダー(例:C:\BoltLynx)を作成し、ZIP 内のすべてのファイルをそこに展開します。ポータブル版のため、インストーラーは不要です。

ZIP ファイルのウィンドウ内から boltlynx-desktop.exe を直接実行しないでください。Windows が一時フォルダーから起動し、後でランチャーやローカルファイルを見つけにくくなる場合があります。

展開先のフォルダーを開き、boltlynx-desktop.exe をダブルクリックします。Windows ランチャーはローカルクライアントを管理するもので、エージェントと対話する画面ではありません。クライアントの起動と停止、ペアリングページの表示またはコピーに使用します。

初期版はまだ署名されていないため、Windows が Microsoft Defender SmartScreen の警告を表示する場合があります。公式ボタンからダウンロードした場合は、More infoRun anyway の順に選択してください。

ウイルス対策ソフトが Windows ランチャーを脅威として検出した場合

ローカルクライアントは、許可されたシステム操作、コマンド、ファイル操作を実行できます。そのため、未署名版は Trojan:Win32/Sprisky.U!cl などのヒューリスティック検出を引き起こす場合があります。警告を自動的に許可しないでください。

  1. まず、ZIP が上の公式ダウンロードボタンから取得したもので、検出されたファイルが C:\BoltLynx\boltlynx-desktop.exe であることを確認します。入手元、ファイル名、または検出されたファイルが一致しない場合は削除し、公式ボタンから再度ダウンロードしてください。
  2. 一致する場合は、Windows セキュリティ → ウイルスと脅威の防止 → 保護の履歴を開き、該当する検出項目でデバイスで許可を選びます。隔離済みの場合は復元を選びます。表示名は Windows のバージョンによって多少異なる場合があります。
  3. 確認済みのファイルが Defender に繰り返し隔離される場合は、ウイルスと脅威の防止の設定 → 設定の管理 → 除外 → 除外の追加または削除を開き、フォルダーを選んで C:\BoltLynx だけを追加します。

リアルタイム保護を無効にしたり、ダウンロード、ユーザーフォルダー全体、ドライブ全体を除外したりしないでください。

Microsoft の手順:保護の履歴フォルダーの除外

ペアリング後は、ローカルクライアントをバックグラウンドで動かしたままにします。Web アプリを開いてエージェントと対話し、使用を許可するプロジェクトフォルダを選びます。

更新がある場合、Windows ランチャーから新しいローカルクライアントをダウンロードできます。ポータブル版のため、ローカルファイルは実行ファイルを起動したフォルダ内に保存されます。

Linux コマンドライン

ローカルクライアントをインストールします:

curl -fsSL https://boltlynx.com/install.sh | bash

インストーラは boltlynx バイナリを ~/.boltlynx/bin/ に配置し、PATH に追加します。ターミナルを再起動してからローカルクライアントを起動します。初回起動時にペアリングページへのリンクが表示されるので、ブラウザで開いて確認してください。その後、ローカルクライアントはバックグラウンドで動作し続けます。別のペアリングコマンドは不要です。

boltlynx start

状態はいつでも確認できます:

boltlynx status

macOS コマンドライン

ローカルクライアントをインストールします:

curl -fsSL https://boltlynx.com/install.sh | bash

インストーラは boltlynx バイナリを ~/.boltlynx/bin/ に配置し、PATH に追加します。ターミナルを再起動してからローカルクライアントを起動します。初回起動時にペアリングページへのリンクが表示されるので、ブラウザで開いて確認してください。その後、ローカルクライアントはバックグラウンドで動作し続けます。別のペアリングコマンドは不要です。

boltlynx start

状態はいつでも確認できます:

boltlynx status

ローカルクライアントを起動してペアリングしたら、Web アプリを開き、エージェントを作成または選択して、使用を許可するプロジェクトフォルダを選びます。

ローカルクライアントをアップデートする

アップデート後:

  • Windows:ランチャーからローカルクライアントをアップデートし、クライアントカーネルを再起動します。
  • Linux / macOS:ターミナルからローカルクライアントを再起動します。
ローカルクライアントを再起動
boltlynx restart

基本概念

Web アプリ

エージェントとの対話、作業の作成と管理、次に行うことの決定をここで行います。Web アプリはブラウザで動作します。

ローカルクライアント

クライアントはあなたのマシンで動作します。許可されたエージェントに、ローカルファイル、コマンド、データ分析、コード検索、非公開スキルへのアクセスを提供します。

クライアントは1つのエージェントではありません。 マシン、コンテナ、または別の OS ユーザーとして分離された実行環境です。その環境に一度導入すれば、複数のエージェントを実行できます。

エージェント

エージェントは、会話と作業環境を組み合わせたものです。会話履歴、作業ディレクトリ、メモリ、有効なスキル、固有の指示を持ちます。

スキル

スキルはエージェントに専門能力を追加します。このガイドでは、ソフトウェア作業向けの Code と、運用・データベース安全規則向けの Ops を扱います。

ワーカーエージェント

メインエージェントは専門のワーカーエージェントに仕事を委任できます。各ワーカーは独自のモデル、作業ディレクトリ、スキル、役割を持てます。

エージェント設定

エージェントごとに、特定のプロジェクトや作業に合わせて設定できます。

名前、説明、作業ディレクトリエージェントを識別し、操作できるルートフォルダを指定します。
スキルCode や Ops などの専門能力を有効にします。
モデル作業に使うモデルと推論レベルを選びます。
ファイル権限許可、書き込み可能、ブロックするパスを設定します。
コマンド権限git * を許可し、破壊的なコマンドをブロックするなど、パターンを設定します。
指示とメモリ会話をまたいで保持できる長期的な作業ルールと編集可能なメモを与えます。
ワーカーエージェント大きな仕事向けに専門の協働エージェントを設定します。
トリガーと通知定期チェック、Webhook によるワークフロー、完了・警告通知を設定します。

日常の使い方

  1. Web アプリを開きます。プロジェクトを担当するエージェントを選び、対話を続けるか、次の作業を依頼します。
  2. 仕事を説明する。 プロンプトだけでなく、実際のタスクを渡します。
  3. 実行させる。 許可された環境でファイルの読み書き、コマンド実行、コード検索、データ分析を行えます。
  4. 機密性の高い操作を承認する。 確認が必要な操作は、先に人の承認を求めます。
  5. 通知を受け取る。 作業完了、異常、定期タスクの報告を BoltLynx から通知できます。

安全モデル

BoltLynx は明確な境界を前提に設計されています。エージェントは、設定したディレクトリとコマンド権限の範囲内で動作します。

  • ファイルアクセスは、作業ディレクトリと追加の許可・ブロック規則で制御されます。
  • 機密性の高いコマンドには人の承認を必須にできます。
  • 非公開スキルはサーバー側ツールとしてアップロードせず、ローカルクライアント経由で実行します。
  • 通知で完了、失敗、定期レポートを確認できます。

データ境界

BoltLynx は、ローカルアクセスとデータ転送を最小限に抑えるよう設計されています。 ワークスペース全体を複製したり、現在の仕事に無関係なファイルを走査してアップロードしたりしません。

作業内容がクライアント外へ送られるのは、モデル推論、作業継続に必要なアクション結果、選択したオンラインサービス、またはサービスの運用と保護に必要な診断の場合に限られます。