ibara

ibara

Omarchy 上のエージェント向けコンピューター操作。

自分のコンピューターで作業を続けながら、予備のコンピューターをエージェントに使わせることができます。エージェントは予備のコンピューターのデスクトップ、ブラウザー、アプリを操作できます。

ibara は Omarchy のバーで動作します。コンソールには、接続済みのコンピューター、その画面、タスクが表示されます。ファイルを送信したり、結果を収集したり、操作を引き継いだりできます。

ウェブサイト · ユーザーガイド · リリースノート · ロードマップ

ibara は無料のオープンソースソフトウェアです。Omarchy コンピューターと Omarchy 仮想マシンで動作します。お使いのコンピューターは、ご自身の Tailscale ネットワークを介して接続します。

はじめる前に

以下のセットアップには、次のものが必要です。

• x86_64 ハードウェア上で Omarchy を実行しているコンピューター 2 台。Hyprland デスクトップとバーが必要です
• Tailscale アカウント。両方のコンピューターでサインインしてください
• 各コンピューターで sudo アクセス権を持つ、ご自身のアカウント
• Codex や Claude Code など、Model Context Protocol（MCP）をサポートするエージェント
• ブラウザータスク用の Google Chrome または Chromium がインストールされた予備のコンピューター

どちらのコンピューターも仮想マシンにできます。予備のコンピューターにマウスやモニターを接続する必要はありません。ibara は必要に応じて仮想画面を作成します。

サポート対象は Omarchy のみです。他のプラットフォームをサポートする予定はありません。0.3.0 および 0.3.1 の Ubuntu パッケージは過去のものであり、現在は更新されていません。

リリース 0.3.1-1 の Omarchy パッケージ 3 個のダウンロードサイズは、追加の依存関係を除いて合計約 52.3 MB です。インストーラーが依存関係をインストールします。

コンピューターをインストールして接続する

1. 各コンピューターで、root ではなくご自身のユーザーとして次のコマンドを実行します。

   curl -fsSL https://github.com/MayberryDT/ibara/releases/latest/download/install | sh
   

2. セットアップの指示に従います。セットアップではパスワードの入力を求められ、バーに ibara アイコンが追加されます。

3. 普段使っているコンピューターで ibara アイコンを右クリックし、コンソールを開きます。

4. 「Add Computer」を選択し、次に予備のコンピューターを選択します。

インストーラーは最新リリースをダウンロードします。インストール前にリリース署名とパッケージのチェックサムを検証します。インストールされるのは ibara、ibara-stream、ibara-view です。

同じ Tailscale ログインを使用し、どちらのコンピューターにもタグが付いていない場合、ご自身のコンピューター同士は 1 ステップでペアリングできます。それ以外のペアリングには確認が必要です。

ペアリングガイドで、それぞれのケースについて説明しています。また、インストール前にリリースを検証することもできます。

エージェントを接続する

1. コンソールで「Connect an Agent」を選択し、次に「Copy Prompt」を選択します。
2. プロンプトをエージェントに貼り付け、セットアップが完了するまで待ちます。
3. エージェントがツールを再読み込みする必要がある場合は、エージェントを再起動します。ibara コンピューターの一覧を表示するよう依頼してください。

ターミナルから接続プロンプトを出力することもできます。

ibara prompt

このプロンプトは、ibara MCP サーバーの追加、スキルのリンク、今後のセッション用の指示の追加をエージェントに指示します。

Codex、Claude Code、opencode、omp で動作を確認しています。他のエージェントには MCP サポートが必要です。エージェント接続リファレンスでは、手動でのセットアップについて説明しています。

最初のタスクを実行する

spare-mini を予備のコンピューターの名前に置き換え、次の内容をエージェントに貼り付けます。

On spare-mini, open https://ibara.app/practice.
Check the Settings menu with the mouse and keyboard.
Take a screenshot with the menu open.
Tell me which checks passed or failed.
Do not change system settings.
Finish the task and release the computer when you are done.

練習用ページへのサインインは不要です。コンソールで予備のコンピューターを確認し、スクリーンショットとレポートを照合してください。

結果には、次の内容が含まれているはずです。

• 各チェック項目の合格または不合格
• メニューを開いた状態を示すスクリーンショット
• タスクが終了し、コンピューターが解放されたことの確認

最初のタスクガイドでは、次にファイルを収集し、ご自身のアプリを確認する方法について説明しています。

ibaraを仕事で使う

エージェントに具体的なタスクを指示し、証拠を求めてください。たとえば、次のように依頼できます。

• マウスとキーボードを使ってウェブアプリを確認し、スクリーンショット付きで不具合を報告する
• ドキュメントを編集して保存し、再度開いて保存内容を確認する
• ページから情報を集め、レポートまたはファイルとして提出する

ローカルの開発サーバーは、スペアからアクセスできる必要があります。localhost ではなく、ステージング URL またはお使いのコンピューターの Tailscale アドレスを使用してください。

スペアには独自のブラウザーセッションがあります。普段使っているコンピューターでサインインしても、スペアではサインインされません。エージェントからのサインイン要求に従うか、自分で操作するために制御を引き継いでください。

セットアップでお困りですか？有料セットアップとサポートは任意です。ソフトウェアは引き続き無料です。

画面を確認して制御を引き継ぐ

コンソールでコンピューターを開くと、画面を確認し、タスクの進行状況を追い、履歴を読むことができます。カードにファイルをドロップすると、そのコンピューターに送信できます。

「Take Control」を選択すると、ビューアーからキーボードとマウスを使って操作できます。操作中はエージェントが一時停止します。

終わったら「Hand Back」を選択してください。ビューアーを閉じただけでは制御は戻りません。エージェントのタスクが終了していた場合は、続行するよう指示してください。

各コンピューターのアクセス権は「Access」タブで管理できます。また、期限切れになる招待や取り消し可能な招待を使って、コンピューターを共有することもできます。

アクセスと制御のガイドでは、権限、招待、エージェントからコンピューターの制御を取り戻す方法について説明しています。

プライバシーとアクセス制限

画像、ファイル、コマンドは、Tailscale の暗号化ネットワークを介してお使いのコンピューター間でやり取りされます。ibara アカウントは必要ありません。

エージェントは、スクリーンショット、テキスト、ファイルの内容をモデルプロバイダーに送信する場合があります。お使いのコンピューターから送信される内容は、使用するエージェントとモデルによって異なります。

ibara は、コンテンツを含まない運用診断情報もローカルに記録します。この診断情報のアップロードは任意であり、別途設定したアーカイブと認証情報が必要です。また、インストール時には有効になっていません。記録とその制限をご覧ください。

ibara は、インストール時または更新時に署名済みリリースを確認します。リリース 0.3.1 には、診断記録を送信するための任意のアップローダーが含まれています。有効にしない限り、オフのままです。

デフォルトでは、送信、支払い、削除、アクセス権の変更として認識された操作には承認が必要です。ご自身のエージェントの承認設定は変更できます。

承認ですべての操作をカバーすることはできません。ibara は、コマンドやクリックが何を引き起こすかを常に判断できるとは限りません。エージェントは隔離された環境に閉じ込められているわけではありません。

そのコンピューターへのアクセスを任せられるエージェントにのみ、アクセス権を与えてください。機密性の高いアカウントやファイルを扱う前に、承認の制限をお読みください。

リリースとテスト結果

リリース 0.3.1-1 では、デスクトップ入力、ブラウザーの検出、クリーンアップ、コンソールの復旧が改善されています。iframe とシャドウルート内のページの読み取りにも対応しています。

このリリースはパッケージチェックと対象を絞ったデスクトップテストに合格しました。より長期のテストでは、各オペレーティングシステムで連続 2 回のクリーンな実行を達成できませんでした。

記録された失敗には、Writer のフォーカスに関する問題、一部しか入力されない問題、ワークブックのエラー、ファイルを再度開いた後の確認不足が含まれます。対象範囲と制限については、0.3.1-1 リリースノートをご覧ください。

2026 年 9 月のベンチマークでは、0.1.0-17 で 157 回中 132 回の実行に合格しました。これは過去の結果であり、現在のリリースの成功率を示すものではありません。

9 月の結果には、失敗を含む公開済みのすべての表が掲載されています。ベンチマークアーカイブには、その他のテストキャンペーンとその手法が記載されています。

ロードマップでは、予定されている作業について説明しています。このリポジトリの main ブランチにあるソースの変更は、最新のパッケージに含まれていない場合があります。

ibara を更新または削除する

変更するコンピューターで、次のコマンドを実行してください。

タスク	コマンド
インストール済みバージョンを表示する	ibara --version
更新を確認する	ibara update --check
最新の署名付きリリースをインストールする	ibara update
可能な場合、前のリリースに戻す	ibara rollback
ID と履歴を保持したまま ibara を削除する	ibara uninstall

ID、ペアリング、履歴、ビューアーの設定も削除するには、ibara uninstall --delete-data を実行してください。受信したファイルは ~/Downloads/Ibara に残ります。

別パッケージの cua-driver-bin は、ほかのソフトウェアで使われる可能性があるため、インストールされたままになります。各エージェントの ibara サーバー、スキルリンク、指示ブロックは個別に削除してください。

データを削除する前に、削除の詳細を確認してください。

サポートを受け、技術ガイドを読む

問題が発生した場合は、まずトラブルシューティングを確認してください。それでも解決しない場合は、問題を報告してください。

詳しくは、次のガイドを参照してください。

• アーキテクチャでは、サービス、ネットワーク接続、保存データについて説明しています
• エージェントツールでは、MCP ツールとその結果について説明しています
• コンポジターの設定では、オプションの Hypoland 入力と、その安全策が限定されることについて説明しています
• 開発では、ソースのビルドと確認方法について説明しています
• 内部構造では、実装について説明しています
• セキュリティ報告では、脆弱性を非公開で報告する方法について説明しています

クレジットとライセンス

ibara のコアとOmarchy コンソールプラグインは、MIT ライセンスを使用しています。コンソールには、Omarchy のプラグインマーケットプレイス用の独立したリポジトリがあります。

Cuaは、デスクトップドライバーと Hyprland プラグインを提供しています。リリース 0.3.1 には Cua 0.34.1 が同梱されています。ベンダー提供のプラグインの変更点は、MIT ライセンスと通知を引き継いでいます。

Take Control は、別個の GPL-3.0 プログラムを使用しています。

• ibara-stream は、単回使用のチケットを介してビューアーを受け入れる Sunshine のフォークです
• ibara-view は、キーボードの引き継ぎ、ファイルドロップ、独自のビューアー ID を備えた Moonlight のフォークです

フォークの詳細では、これらのプログラムが上流プロジェクトとどのように異なるかを説明しています。フォークはリリースのソースアーカイブに含まれています。リリースのダウンロードには、コアとコンソールのソースに加え、各フォークのソース、依存関係、変更点も含まれています。

ibara は、Omarchy、Hyprland、Tailscaleにも依存しています。

バグを報告し、変更を提案する

バグ報告や提案を歓迎します。Tyler が ibara を保守しており、外部からの貢献を直接マージすることはありません。

提案する修正を示すために、プルリクエストを送信できます。Tyler は Claude または Codex を使って提出内容を確認し、どの変更を行うかを独自に判断します。

パッチに時間をかける前に、貢献ポリシーをお読みください。