xisland

xisland 是什么？

xisland 是一款 macOS 动态岛风格应用，可从 macOS 缺口或菜单栏监控和管理 AI 编码代理会话。它专为运行代理工作流（如 Claude Code、Codex 和 Gemini CLI）的开发者设计，让您保持专注，同时观察动态并在需要批准时采取行动。

无需切换窗口查看提示或权限，xisland 在统一面板中显示会话，并支持从动态岛 UI 快速执行操作，如批准工具/文件操作和直接回答代理问题。

主要功能

• 动态岛会话面板（缺口或药丸模式）：显示代理活动，需要关注时展开/折叠，监控保持轻量。
• 支持 AI 代理的统一监控：在同一位置显示 Claude Code、Codex、Gemini CLI 和 OpenCode 的会话。
• 批准代理触发的变更：拦截文件编辑、命令和删除，在动态岛中提供 允许/拒绝 控件，控制代理执行内容。
• 从弹窗回答代理问题：代理提问时，可从动态岛界面响应，无需离开当前编辑器。
• 快速跳转回正确终端/标签/会话：一键返回相应终端上下文，支持多个终端（如 iTerm2、Ghostty、Terminal.app、Warp 等）。
• 键盘优先导航：支持 vim 风格 hjkl 移动和 enter 执行，减少鼠标切换。
• 原生 macOS 实现：使用 Swift 和 SwiftUI + AppKit 构建（非 Electron），追求快速轻量体验。

如何使用 xisland

1. 安装 xisland（可通过 macOS 下载安装，也支持 Homebrew cask）。
2. 选择显示模式：使用 Notch Mode（macOS 缺口）或 Pill Mode（菜单栏紧凑浮动药丸）。
3. 在支持的终端中运行 AI 编码代理。
4. 在动态岛中监控会话，活动出现时查看。若代理请求批准，从弹窗使用 允许/拒绝 控件。
5. 从动态岛面板直接响应问题并跳转回终端，然后继续编码。

使用场景

• 不离开编辑器审查代理权限：Claude Code/Codex/Gemini CLI 请求文件编辑或命令执行权限时，从缺口面板批准或拒绝。
• 处理多步代理运行和并行会话：同时开启多个代理会话时，使用统一面板查看状态/进度，处理需要关注的会话。
• 快速回答交互提示：代理提问（如测试策略选择）时，从动态岛弹窗回答，而非切换窗口。
• 代理与终端协调：一键导航跳转回正确终端、标签和会话，检查或继续工作。
• 开发中保持键盘驱动：使用键盘导航（hjkl + enter）控制批准和交互，无需依赖鼠标。

常见问题

• xisland 支持哪些 AI 编码工具？ 支持 Claude Code、Codex、Gemini CLI 和 OpenCode。这些工具的会话将在统一缺口面板中显示。

• 支持哪些终端？ 支持 Ghostty、iTerm2、Terminal.app、Warp，以及其他终端如 Alacritty、Kitty 和某些 IDE 集成终端（如 VS Code/Cursor/Windsurf）。还支持 tmux 和分屏精确跳转。

• 代理想运行某项操作时，批准机制如何？ 代理请求运行工具或变更权限时，动态岛面板展开显示 允许 和 拒绝 按钮，可无需切换终端即批准或拒绝。

• 可以选择缺口还是菜单栏显示吗？ 可以。xisland 提供 Notch Mode（macOS 缺口）和 Pill Mode（菜单栏浮动药丸），可切换模式。

替代方案

• 每个代理的终端监控/管理： 许多工作流依赖在终端直接阅读代理输出，并在终端手动批准操作。这将一切保持在一个地方，但通常需要更多窗口切换。
• 代理工具的 IDE 或编辑器集成： 某些设置将代理控制集成到编辑器 UI 中。这可以在编辑器内减少上下文切换，但可能无法提供系统级的“动态岛”监控视图。
• 特定代理工具内的聊天/代理仪表板： 如果您使用单一代理平台及其自身 UI，您可能在该生态系统中获得监控，而不是跨多个工具的统一 macOS 面板。
• 通用通知/自动化工具： 您可以将代理事件路由到通知或脚本，但这通常无法提供 xisland 所述的交互式批准和跳转到终端流程。