ibara

ibara

为 Omarchy 上的 Agent 提供电脑控制能力。

给你的 Agent 一台备用电脑，同时你继续使用自己的电脑工作。它可以使用备用电脑的桌面、浏览器和应用。

ibara 在 Omarchy 的栏中运行。它的控制台会显示已连接的电脑、屏幕和任务。你可以发送文件、收集结果并接管控制。

网站 · 用户指南 · 发行说明 · 路线图

ibara 免费且开源。它可在 Omarchy 电脑和 Omarchy 虚拟机上运行。你的电脑通过自己的 Tailscale 网络连接。

开始之前

要完成以下设置，你需要：

• 2 台运行 Omarchy 的 x86_64 硬件电脑，配备其 Hyprland 桌面和栏
• 一个 Tailscale 账号，并在两台电脑上登录
• 每台电脑上有你自己的账号，且拥有 sudo 访问权限
• 一个支持 Model Context Protocol（MCP）的 Agent，例如 Codex 或 Claude Code
• 备用电脑上安装 Google Chrome 或 Chromium，以执行浏览器任务

任一电脑都可以是虚拟机。备用电脑无需连接鼠标或显示器。ibara 会在需要时创建虚拟屏幕。

仅支持 Omarchy。不会计划支持其他平台。0.3.0 和 0.3.1 的 Ubuntu 软件包仅为历史版本，不再接收更新。

3 个 Omarchy 0.3.1-1 发行软件包的下载总量约为 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 登录账号，且两台电脑都未添加标签，它们就可以一步完成配对。其他配对方式需要确认。

配对指南介绍了这些情况。你也可以在安装前验证发行版。

连接你的 Agent

1. 在控制台中选择 Connect an Agent，然后选择 Copy Prompt。
2. 将提示词粘贴到你的 Agent 中，并让它完成设置。
3. 如果 Agent 需要重新加载工具，请重启它。让它列出你的 ibara 电脑。

你也可以在终端中打印连接提示词：

ibara prompt

提示词会指示你的 Agent 添加 ibara MCP 服务、关联其技能，并为后续会话添加说明。

我们已测试 Codex、Claude Code、opencode 和 omp。其他 Agent 需要支持 MCP。Agent 连接参考介绍了手动设置方法。

执行你的第一个任务

将 spare-mini 替换为备用电脑的名称，然后将其粘贴到你的 Agent 中：

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 开展工作

为你的 Agent 指定一项具体任务，并要求它提供证据。例如，可以要求它：

• 使用鼠标和键盘检查 Web 应用，然后附上截图报告问题
• 编辑文档、保存文档、重新打开并检查保存的内容
• 从页面收集信息，并返回报告或文件

本地开发服务器必须能从备用电脑访问。请使用暂存 URL 或电脑的 Tailscale 地址，而不是 localhost。

备用电脑有自己的浏览器会话。在你日常使用的电脑上登录，并不会让你自动在备用电脑上登录。请按照 Agent 的登录请求操作，或接管电脑并自行登录。

需要设置方面的帮助？付费设置与支持为可选服务。软件仍然免费。

查看并接管

在控制台中打开一台电脑，即可查看其屏幕、跟进任务并阅读其历史记录。将文件拖放到电脑卡片上即可发送文件。

选择“接管”，即可通过查看器使用电脑的键盘和鼠标。你使用电脑期间，Agent 会暂停。

完成后，选择“交还”。仅关闭查看器并不会交还控制权。如果 Agent 的任务已经结束，请让它继续。

你可以在“访问权限”选项卡中管理每台电脑的权限。你也可以通过邀请来共享电脑，并设置邀请的过期时间或撤销邀请。

访问与控制指南介绍了权限、邀请，以及如何从 Agent 手中收回电脑。

隐私与访问限制

图片、文件和命令会通过 Tailscale 的加密网络在你的电脑之间传输。你不需要 ibara 账户。

你的 Agent 可能会将屏幕截图、文本和文件内容发送给其模型提供商。哪些内容会离开你的电脑，取决于你使用的 Agent 和模型。

ibara 还会记录本地的、不含内容的运行诊断信息。上传这些诊断信息是可选的，需要单独配置归档和凭据，而且安装时不会启用。请参阅记录及其限制。

安装或更新时，ibara 会检查已签名的版本。0.3.1 版本包含一个可选的诊断记录上传器。除非你主动启用，否则它会保持关闭。

默认情况下，发送、消费、删除和访问权限变更等已识别的操作都需要审批。你可以更改自己 Agent 的审批设置。

审批无法覆盖所有操作。ibara 并非总能判断命令或点击会产生什么效果。Agent 并未被限制在隔离环境中。

只向你信任其使用这台电脑的 Agent 授予访问权限。在使用敏感账户或文件之前，请阅读审批限制。

版本发布与测试结果

0.3.1-1 版本改进了桌面输入、浏览器发现、清理和控制台恢复功能。该版本支持读取 iframe 和 shadow root 内的页面。

该版本通过了软件包检查和针对性的桌面测试。较长时间的测试活动未能在每种操作系统上连续两次通过测试。

记录的问题包括 Writer 焦点异常、输入不完整、工作簿错误，以及重新打开文件后的检查不完整。关于适用范围和限制，请参阅0.3.1-1 版本说明。

2026 年 9 月的基准测试在 0.1.0-17 版本上通过了 157 次运行中的 132 次。这是历史结果，并不代表当前版本的成功率。

9 月测试结果保留了所有已发布的表格，包括失败记录。基准测试存档列出了其他测试活动及其方法。

路线图介绍了计划中的工作。此仓库主分支上的源代码变更可能尚未包含在最新软件包中。

更新或移除 ibara

在要更改的计算机上使用以下命令：

任务	命令
显示已安装的版本	ibara --version
检查是否有更新	ibara update --check
安装最新的已签名版本	ibara update
恢复到之前的版本（如果有）	ibara rollback
移除 ibara，但保留其身份和历史记录	ibara uninstall

如需同时移除身份、配对信息、历史记录和查看器设置，请使用 ibara uninstall --delete-data。已接收的文件仍保留在 ~/Downloads/Ibara 中。

单独的 cua-driver-bin 软件包会继续保留，因为其他软件可能会用到它。请分别移除各个 Agent 的 ibara 服务、技能链接和指令块。

删除数据前，请查看移除详情。

获取帮助并阅读技术指南

如果遇到问题，请先查看故障排除。如果仍需帮助，请报告问题。

如需了解更多详情，请参阅以下指南：

• 架构介绍服务、网络连接和存储的数据
• Agent 工具介绍 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 是 Moonlight 的一个分支，支持键盘交接、文件投递，并使用独立的查看器身份

分支详情说明了这些程序与其上游项目的区别。发行版源代码归档中包含这些分支。发行版下载中包含它们的源代码、依赖项和更改，以及核心和控制台的源代码。

ibara 还依赖 Omarchy、Hyprland 和 Tailscale。

报告错误并提出更改建议

欢迎提交错误报告和建议。Tyler 负责维护 ibara，不会直接合并外部贡献。

你可以提交拉取请求来展示拟议的修复方案。Tyler 会使用 Claude 或 Codex 审查提交内容，并独立决定要进行哪些更改。

花时间编写补丁前，请阅读贡献政策。