Alookを読む：人とローカルAIエージェントを同じ部屋で協働させる層

人とエージェントが同じ部屋を持つ考え方

Alookは、利用者とAIエージェントが同じ部屋で会話し、作業するための協働レイヤーです。READMEは、ローカルのコーディングエージェントへ固有の身元、ハンドル、受信箱、メンバーシップを与え、サーバー、チャンネル、ダイレクトメッセージで人間と同じように呼び出せると説明しています。

利用者はすでに使っているエージェントを共有ルームへ連れていきます。Alookが独自モデルを供給、ホストするのではなく、エージェントは自分のマシンで実行され、Alookはそこへ到達する方法を提供します。この分担は、モデル選択やコード実行を自分の環境に残しながら、会話と作業の窓口を共有したい場合に合います。

ただし、共有ルームへ入れる相手は信頼できる人に限定する必要があります。エージェントが作業ディレクトリやコードへアクセスできる範囲、誰が指示を送れるか、返信とメモリを誰が読めるかは、READMEの短い紹介だけでは確定しません。Alookを導入する前に、エージェントの実行権限と共有範囲を組織の規則へ落とし込みます。

オンボーディングとローカル接続

Quick Startはnpx @alook/app onboardです。READMEによると、このコマンドはマシン接続、ランタイム検出、Alookのローカル起動を案内し、完了後はhttp://localhost:15210を開きます。別の入口として、alook.aiへアクセスし、ローカルランタイムを接続する方法もあります。

この手順は短く、初期導入を始める入口として分かりやすい一方、OS要件、Nodeの版、ネットワーク条件、既存ランタイムの検出規則、失敗時の復旧はREADMEに詳細がありません。コマンドを実行する前に、作業ディレクトリ、認証情報、エージェントの設定、待受ポート、Firewall、ログ保存場所を確認します。

ローカル接続を採用する場合、Alookの管理画面や共有機能が利用できても、エージェントの処理が外部へ移るとは限りません。READMEが掲げるローカル優先の意味を、自分のネットワーク、作業ファイル、ログ、メモリ、添付データで確認します。起動成功と安全な分離は別の判定です。

対応ランタイムを選ぶ前の確認

READMEの表では、Claude Code、Codex、Cursor、OpenCode、PiがSupportedとして挙げられています。Alookは特定のAIモデルを供給する製品ではなく、利用者のマシンにあるランタイムへ接続する設計です。対応表は接続候補を示しますが、各ランタイムの全機能、版互換性、同時実行、権限、作業ディレクトリを保証するものではありません。

エージェントを登録するときは、表示名、固有ID、利用するランタイム、実行場所、作業ディレクトリ、入力経路、出力経路を記録します。同じランタイムを複数のエージェントとして登録する場合は、どのエージェントがどのリポジトリと資格情報へアクセスするかを分けます。共有ルームで送られた指示が、意図したエージェントへだけ届くかを確認してください。

Cursorや各種CLIのようなランタイムは、設定、認証、プロセス管理が異なる可能性があります。READMEはSupportedという状態を示すだけで、対応版、制約、サポート期限を説明していません。導入後は文章返信だけでなく、ファイル変更、コマンド実行、長時間処理、停止、再接続、権限拒否を一つずつ確認します。

ローカル優先と常時接続の境界

Alookの機能説明にはLocal-first & Always-onがあります。エージェントは利用者のマシンに残り、信頼した人がAlookから会話できるという考え方です。Desktopまたはphoneから同じ部屋、同じ人、同じエージェントへ到達できるとも説明されています。

ここで確認すべきなのは、会話の到達性とコードの保存場所を分けることです。ローカルエージェントが作業ディレクトリを読むなら、共有相手が何を指示できるか、返信にどのファイル内容が含まれるか、ログとメモリがどこへ保存されるかを確認します。外出先からスマートフォンで送った指示が、ローカルの実行環境で直ちに処理されるなら、電源、接続、通知、停止条件も運用対象です。

常時接続を自動的な無制限実行と解釈しないでください。長時間の処理、破壊的なコマンド、外部送信、秘密情報へのアクセスには、確認や許可を置きます。READMEは可用性、暗号化、認証強度、監査保存、障害復旧時間を示していないため、組織の安全基準を別に適用します。

メモリ、受信箱、固有IDの運用

Alookの機能にはOne identityとMemory with initiativeがあります。エージェントは人間のような固有の身元を持ち、各部屋で同じエージェントとして認識されます。完了した作業から文脈を積み上げ、利用者が毎回すべてを思い出さなくても作業を前へ進めるという説明です。

固有IDは識別と権限管理の基礎になります。表示名を変更しても同じエージェントを追跡できるか、退職者が共有ルームから外れたときにエージェントの受信箱とメモリをどう扱うか、同じエージェントが複数のコードベースへアクセスできるかを決めます。READMEは保持期間、削除、エクスポート、監査、メモリの編集方法を説明していません。

Memory with initiativeという説明は製品側の機能主張です。記憶された文脈が正しいとは限らず、古い指示や秘密情報が後の作業へ混ざる可能性があります。メモリへ保存してよい内容、保存禁止の内容、利用者による確認、削除依頼、部屋ごとの分離を明文化し、記憶の存在を自動承認と解釈しない運用が必要です。

構成図に示されるクライアントと保存層

READMEの構成図は、Agent Machine、Hosted Machine、Storageという領域を示しています。エージェント側には@alook/daemonとAgent Workdir、ホスト側には@alook/appとQueues、保存層にはSQLiteとFilesが描かれています。技術スタックとしてNext.js、Cloudflare Workers、Bunも記載されています。

図から、ローカルのエージェント作業場所と、AlookのWeb、キュー、SQLite、ファイル保存を分ける考え方は読み取れます。ただし、図の矢印や通信内容、認証、暗号化、保存期間、バックアップ、削除、障害時の再送、キューの順序保証はREADMEの記述だけでは確定しません。構成図を脅威モデルや運用保証として使うことはできません。

導入前には、コードが置かれるAgent Workdir、部屋のメッセージ、受信箱、メモリ、添付ファイル、ログ、キューを個別に確認します。ローカル保存とホスト保存を分け、誰が読めるか、どの時点で削除されるか、エージェント停止時にキューがどうなるかを自分の環境で確認してください。

Apache-2.0とコミュニティ情報

AlookのライセンスはApache-2.0です。コードを利用、変更、再配布する場合は、ライセンス文、著作権表示、NOTICE、変更表示、特許条項を配布形態に合わせて確認します。Alook本体のライセンスと、接続するClaude Code、Codex、Cursor、OpenCode、Pi、依存パッケージ、外部サービスの条件は別々に管理します。

READMEはDiscordと公式サイトをコミュニティ入口として示し、CONTRIBUTING.mdへ貢献手順を案内しています。Discordへの参加や公式サイトの存在は、回答時間、障害対応、可用性、データ保護、商用支援を保証しません。Issueや文書の変更を採用判断へ使うときは、対象版と根拠を記録します。

素材のリポジトリ情報では、スター1165、フォーク186、オープンIssue85、デフォルトブランチmain、アーカイブされていない状態、最新版v0.1.24が確認できます。数字は取得時点のメタデータであり、利用者数、品質、保守期限、セキュリティ保証を示しません。製品説明と検証済みの運用事実を分けて扱うことが必要です。

共有前に決める権限と復旧手順

Alookをチームへ導入する前に、共有する部屋、参加者、エージェント、リポジトリ、作業ディレクトリを一覧化します。人間が送れる指示、エージェントが実行できる操作、他の部屋へ伝播する記憶、外部サービスへ送れるデータを分けます。信頼関係が変わったときに部屋、受信箱、固有ID、メモリ、トークンを停止できるかを確認してください。

次に、通信停止、ローカルマシン停止、エージェントクラッシュ、キュー重複、認証失敗、作業途中の変更、誤った指示を試します。READMEに障害復旧やキュー保証の説明はないため、停止中の指示が再接続後に自動実行されるか、実行済みとして重複しないか、未完了作業を誰が引き継ぐかを実機で確かめます。

最後に、Alookを使う範囲を決めます。低リスクな調査やレビュー補助から始め、コード変更、依存更新、公開、資格情報操作、削除処理へ進むときは承認を追加します。オンボーディングが完了し、部屋が表示されたことは、本番の権限設計と復旧条件を満たした証拠ではありません。READMEの機能主張、構成図、ライセンスを参照しつつ、最終判断は自社のデータ、権限、監査、停止手順で行ってください。

権限表には、利用者、エージェント、部屋、リポジトリ、作業ディレクトリ、保存ファイル、外部サービスを行として置き、閲覧、投稿、実行、変更、削除、共有の可否を列として記録します。新しい参加者を招待したとき、過去の受信箱やメモリを読めるか、過去の指示を再実行できるか、別の部屋へ情報を持ち出せるかを確認します。固有IDが人間のアカウントと混同されないよう、名称、役割、実行端末、担当者を表示します。

メモリ管理では、作業上の事実、利用者の好み、秘密情報、個人情報、推測、完了済みの判断を区別します。保存可能な情報と保存禁止の情報を定め、部屋が変わったときに文脈を継承するかを明示します。古い記憶が新しい指示と衝突した場合は、記憶を自動適用せず、利用者へ確認を返します。削除依頼、退会、リポジトリ移管、端末廃棄のときに、受信箱、メモリ、ファイル、SQLite、キュー、ログをどの順で消去するかも記録します。

実行監査では、誰がどの部屋から、どのエージェントへ、どんな指示を送り、どの作業ディレクトリで、何時に処理したかを保存します。返信内容だけでなく、ファイル変更、コマンド、外部通信、失敗、停止、再接続を追跡します。ただし、監査ログそのものに秘密情報やコード全文を保存しないよう項目を限定し、閲覧権限と保存期間を定めます。READMEは暗号化、ログ規則、保存期間を説明していないため、組織の規程で補います。

停止試験では、ローカル端末の電源断、ネットワーク断、AlookのWeb停止、エージェント停止、キューの再送、認証期限切れを別々に試します。再接続後に保留指示が自動実行されるか、重複処理が起きるか、作業状態を人間が確認できるかを記録します。危険な処理は承認がない限り再開しない状態にし、復旧したことと処理が完了したことを分けて表示します。

Alookはローカルエージェントを共有するための接続層ですが、利用者の組織規則、コードレビュー、秘密管理、法務確認を代替しません。Claude Code、Codex、Cursor、OpenCode、Piの対応表、@alook/app onboard、localhost:15210、構成図、Apache-2.0は導入を始める根拠です。実行権限、部屋の信頼境界、メモリの保持、キューの復旧、ログの保護、停止手順を検証できた範囲だけを業務利用へ広げてください。

共有ルームの試験では、通常会話、作業依頼、複数人の同時指示、返信の宛先、添付情報、長時間処理を分けて確認します。エージェントが人間の指示を受けたこと、作業を開始したこと、ファイルを変更したこと、結果を返信したことを別の状態として表示します。通知だけを見て完了と判断せず、作業ディレクトリの差分と実行ログを承認者が確認します。外出先からの指示は、端末の紛失や誤送信を想定し、停止操作と認証更新を準備します。

構成更新時は、@alook/app、@alook/daemon、Bun、Next.js、Cloudflare Workers、SQLite、保存ファイルの版を記録します。機能追加で部屋、キュー、メモリ、受信箱の形式が変わった場合に備え、更新前のバックアップと復元手順を用意します。READMEに更新互換性、保存形式、障害補償の記述はないため、v0.1.24を採用しても長期互換を推測しません。人間による承認、監査、削除、復元が確認できた範囲だけを継続利用します。

編集部の結論

Alookは、すでに自分のマシンで使っているAIコーディングエージェントを、信頼した人との共有ルームへ参加させたいチームに候補となります。READMEは、エージェントごとの固有ID、受信箱、メンバーシップ、ローカル実行、デスクトップとスマートフォンからの到達、Claude Code、Codex、Cursor、OpenCode、Piの対応を説明しています。一方、メール、メモリ、キュー、SQLite、ファイル、ホスト側処理の保護境界、利用量、障害復旧、サポート条件は十分に記載されていません。導入前に共有相手、権限、作業ディレクトリ、秘密情報、停止時の動作を自分の環境で確認してください。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes