给编程 Agent 的原生 macOS 工作台A native macOS workbench for coding agents

一个窗口,
看住所有 Agent。
One window
for every agent.

谁在运行,谁在等你,一眼看清。多个编程 Agent、本地目录和 SSH 会话,都在同一个窗口。

See who is working and who is waiting on you.Coding agents, local folders, and SSH sessions, all in one window.

macOS 14 及以上 · Apple 芯片 · 免费,MITmacOS 14 or later · Apple silicon · Free, MIT

codex · shop

~/src/waitlight main

❯ claude

● Reading Sources/UI/SidebarView.swift

● Editing Sources/UI/ActivityBadge.swift

+ 18 − 2 ActivityBadge.swift

● 跑一遍测试…Running the tests…

~/src/shop main

❯ codex

● 跨州订单的税额算错了,改这一处:Tax is wrong on cross-state orders. One change:

Sources/Checkout/CheckoutTax.swift

− let rate = store.taxRate

+ let rate = taxRate(for: order.address)

允许修改 CheckoutTax.swift?Allow edit to CheckoutTax.swift?

1 Yes2 Yes, don't ask again3 No

~/src/api main

% grok

✓ 订单接口加了分页,测试通过。Orders endpoint paginated, tests pass.

进程已退出,回到了 shell。The process exited. You are back at the shell.

%

~/notes

❯ gemini

● Editing weekly.md

+ 23 − 4 weekly.md

✓ 本轮完成:周报草稿整理好了。Turn complete: the weekly draft is tidied up.

❯

~

%

ecs-prod · ubuntu · tmux

已重新挂上。原来的 tmux 会话还在,里面的 Agent 也在。Reattached. The tmux session is still there, agent included.

这台机器上没有为 Waitlight 安装任何东西。Nothing was installed on this machine for Waitlight.

ubuntu@ecs-prod:~/app$

可点的界面示意:点会话换终端,「‹ ›」在 Agent 之间切换,右上角可以打开性能面板。「查看总览演示」会跳到下面可以操作的 Agent 总览。点上方会话切换内容,点「总览」体验多 Agent 管理。A clickable sketch: choose a session to change the terminal, step through agents with ‹ ›, and open the performance panel at the top right. “See the overview demo” jumps down to a working agent overview.Tap a session above to switch, and tap Overview to try managing several agents.

内置支持Works with

自动检测你装了哪些,菜单里只列这些;没装的在 App 里点「安装」就行。Waitlight detects which ones you have and lists only those. Install the rest from inside the app.

状态Status

不用切过去,也知道该看谁。See who needs you without switching over.

每个 Agent 旁边都有一盏状态灯。四种颜色,四个意思。Every agent carries a status light. Four colors, four meanings.

  1. 运行中Working

    这一轮还没结束。你可以先去忙别的。

    This turn is still going. You can leave it to it.

  2. 等你Needs you

    它停下来等一次确认或回答。⌘⇧J 跳到下一个。

    It stopped for a confirmation or an answer. ⌘⇧J jumps to the next.

  3. 本轮完成Turn done

    这一轮结束了,会话还在。点进去看结果,或接着说。

    The turn is finished and the session is still there. Read the result, or carry on.

  4. 已退出Exited

    Agent 已退出,回到 shell。支持的 Agent 可恢复之前的对话。

    The agent exited and you are back at the shell. Supported agents can resume the earlier conversation.

状态如何识别How status is detectedhooks、通用信号和几个例外hooks, generic signals, and a few exceptions
  • Claude Code 用它自己的 hooks 报告状态。Waitlight 只在启动时加上参数,不改你的设置文件。Claude Code reports through its own hooks. Waitlight passes flags at launch and never edits your settings files.
  • Grok 和 Codex 也能这样报告,在「管理 Agent」里打开就行。它们只从自己的配置目录读 hooks,所以会各新建一个 Waitlight 自己的文件:~/.grok/hooks/waitlight.json 和 ~/.codex/waitlight.config.toml。你已有的配置不动,关掉开关就删除,在 Waitlight 之外它们什么也不做。两个 Agent 都会先让你信任新 hook。Grok and Codex can report the same way once you turn it on in Manage Agents. They only read hooks from their own config folder, so each gets one new file of Waitlight's own: ~/.grok/hooks/waitlight.json and ~/.codex/waitlight.config.toml. Your existing config is left as it is, turning the switch off deletes the file, and the hook does nothing outside Waitlight. Both agents ask you to trust a new hook first.
  • 没有 hooks 的 Agent 靠通用信号判断:回车、响铃、通知和进度。Agents without hooks are read from generic signals: Return, the bell, notifications, and progress.
  • 刚启动、还在等第一次输入时,显示「就绪」。普通 Shell 没有这些状态。Right after launch, before the first prompt, the label is 就绪 (ready). A plain shell has none of these states.
  • 响铃和通知也会在 Dock 上标出来。SSH 断了以后提示为「已断开」,旁边有重连按钮,⌘⇧R 也会重连。Bells and notifications also badge the Dock. A dropped SSH session is marked 已断开 (disconnected) with a reconnect button; ⌘⇧R reconnects too.
  • 动效也有含义:运行中,文字上有一道光扫过;等你,圆点外面的圈会扩出去。系统打开「减弱动态效果」后,这些动画会停。The motion means something: while working, a light sweeps across the label; while waiting, a ring expands from the dot. With Reduce Motion on, the animation stops.

总览Overview

所有 Agent,列在一屏里。Every agent, on one screen.

⇧⌘A 把终端换成一张列表,每个 Agent 一行。会话都还在后台跑着。⇧⌘A swaps the terminal for a list, one row per agent. Every session keeps running behind it.

Waitlight

Agent 总览 · 4 个 Agent · 1 个等你Agents · 4 agents · 1 needs you

+ 新建 AgentNew agent
Claude Codeshop

等你Needs you 1

运行中Working 1

空闲Idle 1

已退出Exited 1

Codex~/src/shop

这是可以操作的示意:回应等待、回一句话、派一个新任务,列表都会跟着变。This sketch works: answer a prompt, send a reply, or hand out a task, and the list follows.

远程Remote

本地和远程,排在同一条侧边栏。Local and remote, in the same sidebar.

~/.ssh/config 里的主机直接出现在「服务器」里,服务器上什么都不用装。断线重连后,跑在 tmux 或 zellij 里的会话会挂回原处。Hosts from ~/.ssh/config show up under Servers, with nothing to install on them. After a reconnect, a session running in tmux or zellij attaches right where it was.

连接、回连和远程采样的条件Connecting, reattaching, and remote stats
  • 「服务器」里有你添加的主机,也有 ~/.ssh/config 里的别名,Include 进来的文件也算。可以填地址、用户、端口、密钥或 ssh-agent,也支持 ProxyJump。密码放在钥匙串里。Servers lists hosts you add and every alias in ~/.ssh/config, including files pulled in with Include. You can set the address, user, port, key or ssh-agent, and ProxyJump. Passwords go in the Keychain.
  • 默认是自动:机器上已经有 tmux 或 zellij 就用它,没有就开一个普通登录 shell,不会催你去装。Auto is the default: if the machine already has tmux or zellij, Waitlight uses it. If not, you get a normal login shell, with no prompt to install anything.
  • 重连时,如果当时跑在 tmux 或 zellij 里,会挂回原来的会话,里面的 Agent 还在。没有多路复用器的话,就按你配置的目录重新登录,之前的进程不会回来。On reconnect, a session that was in tmux or zellij attaches again, so the agent is still there. Without a multiplexer, it logs in again in the directory you set, and the earlier processes are gone.
  • 性能面板跟着当前会话。看 SSH 会话时采样的是那台服务器:只开一条 SSH,用一小段 POSIX shell 去读 /proc,仍然不用装东西。远程采样目前只支持 Linux。The performance panel follows the selected session. For SSH it samples that server over one connection: a small POSIX shell loop reading /proc, still with nothing to install. Remote sampling currently supports Linux only.

对话Conversations

重新打开,接着之前的工作。Open it again and pick up where you were.

重启 App,或者重新启动一个已经退出的 Agent,Claude Code、Grok 和 Codex 会回到同一段对话。分屏、分组和 SSH 连接也按退出前的样子回来。Relaunch the app, or start an agent that had exited, and Claude Code, Grok, and Codex return to the same conversation. Splits, groups, and SSH connections come back the way you left them.

对话是怎么对上的How conversations are matched
  • 回到同一段对话靠的是对话 id。Claude Code 和 Grok 在启动时就带上 Waitlight 分配的 id。Codex 不能预先指定,要等它收到第一条提问、写出会话文件后,Waitlight 才从 ~/.codex/sessions 里对上。Returning to the same conversation depends on a conversation id. Claude Code and Grok start with an id Waitlight assigns. Codex cannot be given one up front: once it has received its first prompt and written its session file, Waitlight matches the id from ~/.codex/sessions.
  • 没有 id 的时候(Gemini,或者还没提过问的 Codex):重启 App 会接上这个文件夹里最近的一段对话;在 App 里重新启动一个已退出的 Agent,则是开一段新对话。Without an id (Gemini, or Codex before its first prompt): relaunching the app continues the most recent conversation in that folder, while restarting an exited agent inside the app starts a new conversation.
  • ⇧⌘O 按文件夹列出过去的对话,选一段恢复。支持 Claude Code、Codex 和 Grok。⇧⌘O lists past conversations for a folder, so you can resume one. It covers Claude Code, Codex, and Grok.
  • 自定义 Agent:「新对话参数」和「恢复对话参数」里都写了 {id},Waitlight 才会自己生成 id 并回到同一段对话。只填了「继续最近对话参数」的,重启 App 时接最近一段。两样都没填,每次都是新对话。Custom agents: Waitlight generates an id and returns to the same conversation only when both the new-conversation and the resume arguments contain {id}. With only the continue-latest arguments filled in, relaunching the app continues the most recent conversation. With neither, every start is a new conversation.
  • 从 Docker 容器打开的会话,下次启动 App 时不会恢复。第一次打开、没有可恢复的内容时,会在家目录开一个 shell。Sessions opened from a Docker container are not restored on the next launch. With nothing to restore, Waitlight opens a shell in your home directory.

快捷键Keys

手不用离开键盘。Keep your hands on the keyboard.

⌘⇧J

跳到下一个等你的会话Jump to the next session that needs you

⇧⌘A

打开 Agent 总览Open the agent overview

⌥⌘[⌥⌘]

上一个 / 下一个 Agent,跨会话Previous / next agent, across sessions

⌘D⌘⇧D

向右分屏 / 向下分屏Split right / split down

⇧⌘O

恢复这个文件夹里以前的对话Resume an earlier conversation for this folder

⌘⇧R

重新连接 SSHReconnect SSH

更多快捷键More shortcuts会话、窗格、查找、粘贴sessions, panes, find, paste
⌘⇧[⌘⇧]

上一个 / 下一个会话Previous / next session

⌘1⌘9

跳到对应的会话Jump to a session by number

⌘⇧↩

放大 / 还原当前窗格Zoom / restore the current pane

⌘F

在回滚里查找Find in the scrollback

⌘V

把截图或文件贴成路径Paste a screenshot or file as a path

⌥⌘P

打开性能监视器Open the performance panel

⌘⇧W

关闭当前会话Close the current session

⌘,

设置Settings

还有这些Also内置 Agent、贴图、输入法、分组、Docker、更新built-in agents, image paste, input methods, groups, Docker, updates
  • 内置主流的 Agent 命令行工具:Claude Code、Codex、Gemini、Grok、opencode、Qwen Code、Cursor CLI、Copilot CLI、Droid、Amp、Crush、Aider,外加 Shell。装了哪些,新建会话的菜单里就只列哪些。没装的在「管理 Agent」里点「安装」,会新开一个终端跑安装命令,装完自动出现在菜单里。其他命令行工具可以自己加。The mainstream agent CLIs are built in: Claude Code, Codex, Gemini, Grok, opencode, Qwen Code, Cursor CLI, Copilot CLI, Droid, Amp, Crush, and Aider, plus a shell. The new-session menu lists only the ones you have installed. For the rest, Install in Manage Agents runs the install command in a new terminal, and the agent shows up in the menu once it is done. Any other CLI can be added.
  • Agent 的命令是打进登录 shell 的,Agent 退出以后,你还在那个 shell 里。An agent's command is typed into your login shell, so when the agent exits you are still in that shell.
  • 状态跟着窗格走,不跟着会话。在分屏里自己敲 claude 或 codex,Waitlight 也认得出来,它会有自己的状态,也会出现在总览里。Status belongs to the pane, not the session. Type claude or codex into a split yourself and Waitlight notices: it gets its own status and its own row in the overview.
  • 剪贴板里如果是截图,⌘V 会先存成 PNG,再贴上路径,这样就能把图交给 Agent。拷进来或拖进来的文件,会变成 shell 转义后的路径。If the clipboard holds a screenshot, ⌘V saves a PNG and pastes the path, which is how you hand an image to an agent. Copied or dragged files paste as shell-escaped paths.
  • 中文、日文、韩文输入法可以用,候选窗贴着光标。Chinese, Japanese, and Korean input methods work, with the candidate window anchored at the cursor.
  • 会话可以重命名,也可以放进分组。分组是侧边栏里可折叠的一段。Sessions can be renamed or moved into a group. A group is a collapsible section in the sidebar.
  • 性能面板里还有 Docker。可以看容器日志、进容器开一个 shell,也可以启动、停止或重启。从容器打开的会话,下次启动 App 时不会恢复。The performance panel also lists Docker containers. You can open logs, a shell inside a container, and start, stop, or restart one. Sessions opened from a container are not restored on the next launch.
  • 每天会查一次更新,菜单里也可以自己检查。更新来自 GitHub Releases,要有 EdDSA 签名,并且 Developer ID 得和当前这个 App 一致。如果有 Agent 正处在这一轮里,重启前会先问你。Waitlight checks for an update once a day, and you can check from the menu. Updates come from GitHub Releases. Each one is EdDSA-signed and must carry the same Developer ID as the app you have. If an agent is mid-turn, it asks before restarting.
全部细节All the details窗格、查找、Agent、服务器、性能面板、设置panes, find, agents, servers, performance panel, settings

窗格Panes

  • ⌘[⌘] 或 ⌘⌥←↑↓→ 在窗格之间移动。⌘[⌘] or ⌘⌥←↑↓→ move between panes.
  • ⌘⌃←↑↓→ 调整大小,⌃⌘= 均分,⌘W 关闭当前窗格。⌘⌃←↑↓→ resize, ⌃⌘= equalizes, ⌘W closes the pane.
  • 新窗格沿用当前文件夹。布局在重启 App 后恢复。A new pane starts in the current folder. Layouts are restored on relaunch.

查找与回滚Find and scrollback

  • ↩⇧↩ 或 ⌘G⇧⌘G 在匹配之间前后跳,旁边有匹配计数。↩⇧↩ or ⌘G⇧⌘G step through matches, with a match counter.
  • ⌘E 用选中的文字查找。⌘E searches for the current selection.
  • ⌘↑⌘↓ 在提示符之间跳。滚动指示条可以直接拖。⌘↑⌘↓ jump between prompts. The scroll indicator can be dragged.

AgentAgents

  • 在会话里,工具栏显示当前是第几个 Agent(比如 2/5),两边的箭头去上一个和下一个。In a session, the toolbar shows which agent you are on (2/5, say), with arrows to the previous and the next.
  • 派发的任务通过「带提示词启动参数」里的 {prompt} 交给 Agent。内置的大多已经配好(Amp、Crush、Aider 除外);自定义 Agent 填了才会出现在派发栏里。A task reaches the agent through {prompt} in its prompt arguments. Most built-in agents have it set (all but Amp, Crush, and Aider); a custom agent is offered in the bar once you fill it in.
  • ⌘⇧1…⌘⇧9 按「管理 Agent」里的顺序新建会话,只算已经装好的。⌘⇧1…⌘⇧9 open a new session, in the order shown in Manage Agents, counting only installed agents.
  • 自定义 Agent 可以分别填新对话、恢复对话、继续最近对话的参数。参数里的 {id} 会换成对话 id。A custom agent takes separate arguments for a new conversation, resuming one, and continuing the latest. {id} in them becomes the conversation id.
  • Waitlight 在你登录 shell 的 PATH 里找这些命令,所以 nvm、~/.local/bin 里装的也能找到。切回 Waitlight 时会重新检测,在别处刚装的也会出现。Waitlight looks for the commands on the PATH of your login shell, so ones installed through nvm or in ~/.local/bin are found. It checks again when you switch back to it, so an agent you just installed elsewhere shows up too.

服务器Servers

  • 编辑服务器时有命令预览和「测试连接」,会显示系统、有没有 tmux 或 zellij、已有哪些会话。The server editor shows a command preview and a Test Connection button, which reports the OS, whether tmux or zellij is installed, and existing sessions.
  • 可以按服务器指定用 tmux 或 zellij,也可以附加到一个已有的会话。You can force tmux or zellij per server, or attach to an existing session.
  • 右键 ~/.ssh/config 里的条目可以把它从列表里拿掉。只是在 Waitlight 里隐藏,文件不会被改,之后可以恢复。Right-click an entry from ~/.ssh/config to remove it from the list. It is only hidden in Waitlight; the file is not edited, and hidden entries can be restored.
  • Ghostty 的 ssh 集成照常可用(ssh-terminfo、ssh-env)。The ssh integration from Ghostty works as usual (ssh-terminfo, ssh-env).

性能面板Performance panel

  • CPU(每核,服务器上还有负载)、内存、GPU(Apple GPU,服务器上通过 nvidia-smi 读 NVIDIA)、网络、磁盘。CPU (per core, plus load average on servers), memory, GPU (Apple GPU, or NVIDIA through nvidia-smi on servers), network, and disk.
  • 「会话占用」:在 Mac 上是每个会话的进程树,在服务器上是最忙的几个进程。Session usage: the process tree of each session on the Mac, the busiest processes on a server.
  • 显示哪些、多久刷新一次(1、2 或 5 秒)可以在面板菜单里选。Choose which monitors to show and how often they refresh (1, 2, or 5 seconds) from the panel menu.
  • 面板默认关着。关着或窗口隐藏时不采样,也不保持连接。The panel is closed by default. While it is closed or the window is hidden, nothing is sampled and no connection is kept.

设置Settings

  • 终端:配色主题(Ghostty 自带的全部主题加你自己的,带色块和搜索)、字体、字号、行高、光标样式和闪烁、内边距。Terminal: color theme (every theme bundled with Ghostty plus your own, with swatches and search), font, size, line height, cursor style and blink, padding.
  • 还有 Option 当作 Alt、选中即复制、打字时隐藏鼠标。改动带实时预览,叠在你的 Ghostty 配置上面,立刻作用到所有终端,但不会写回文件。Also Option as Alt, copy on select, and hiding the mouse while typing. Changes preview live, are layered on top of your Ghostty config, and apply to every terminal immediately. The file is never modified.
  • 中文默认统一用苹方显示,粗细和标点位置都一致,也可以换成别的字体。Chinese, Japanese, and Korean text uses PingFang SC by default, so weights and punctuation stay consistent; you can pick another font.
  • 外观:背景不透明度 30–100%,以及模糊程度,文字始终不透明。只在 Waitlight 里生效。Waitlight 本身只有深色。Appearance: background opacity from 30 to 100%, and blur. Text stays opaque. This applies inside Waitlight only, and Waitlight is always dark.

常见问题FAQ

你可能想问的。Things you might ask.

Waitlight 是什么?What is Waitlight?

Waitlight 是一个原生 macOS 应用,用来并排运行多个 AI 编程 Agent(Claude Code、Codex、Gemini 等),本地和 SSH 服务器上的都行,一条侧边栏告诉你哪个 Agent 在等你。每一格都是真正的 Ghostty 终端。Waitlight is a native macOS app for running multiple AI coding agents (Claude Code, Codex, Gemini and more) side by side, locally or over SSH, with one sidebar that shows which agent needs you. Every pane is a real Ghostty terminal.

AgentDeck 呢?What happened to AgentDeck?

就是它。Waitlight 0.10 之前叫 AgentDeck,因为同名的项目太多才改名。已经装了的直接在 App 里更新,会话、服务器和设置都会留着。This is it. Waitlight was called AgentDeck before 0.10 and was renamed because too many other projects share that name. If you have it installed, update from inside the app; your sessions, servers and settings carry over.

支持哪些 Agent?Which agents does it work with?

内置 Claude Code、Codex、Gemini、Grok、opencode、Qwen Code、Cursor CLI、Copilot CLI、Droid、Amp、Crush 和 Aider,其他命令行工具也可以自己加。Waitlight 会检测你装了哪些,没装的可以在 App 里一键安装。Claude Code, Codex, Gemini, Grok, opencode, Qwen Code, Cursor CLI, Copilot CLI, Droid, Amp, Crush and Aider are built in, and any other CLI can be added. Waitlight detects which ones you have installed and can install the rest from inside the app.

免费吗?开源吗?Is it free and open source?

免费,开源,MIT 许可。源码在 GitHub 上:github.com/CassianFlorin/Waitlight。Yes. It is free and MIT licensed, with the source on GitHub at github.com/CassianFlorin/Waitlight.

需要什么系统?怎么安装?What do I need, and how do I install it?

macOS 14 或更新版本,Apple 芯片。用 Homebrew 安装:brew install --cask cassianflorin/tap/waitlight,或者从 GitHub Releases 下载 DMG。安装包经过 Apple 签名和公证,装好后会自己更新。macOS 14 or later on Apple silicon. Install it with Homebrew, brew install --cask cassianflorin/tap/waitlight, or download the DMG from GitHub Releases. It is signed and notarized by Apple, and updates itself.

服务器上要装东西吗?Do I need to install anything on my servers?

不用。Waitlight 走普通的 SSH,~/.ssh/config 里的服务器直接能用。服务器上有 tmux 或 zellij 就会用上,断线重连后 Agent 还在原地跑。性能面板也是通过同一条 SSH 读取 Linux 的 /proc。No. Waitlight uses plain SSH, and the hosts in ~/.ssh/config just work. If the server has tmux or zellij, Waitlight uses it, so after a dropped connection it reattaches with the agent still running. The performance panel reads Linux's /proc over the same SSH connection.

和在 iTerm 或 tmux 里多开几个标签有什么区别?How is it different from tabs in iTerm or tmux?

终端还是那个终端(Ghostty),多出来的是每个 Agent 的状态:谁在运行,谁卡在权限确认上等你,谁这一轮做完了。⌘⇧J 直接跳到下一个等你的,Agent 总览能在一屏里看全部、直接回复、派新任务,重启 App 后 Agent 回到同一段对话。The terminal is still a terminal (Ghostty). What Waitlight adds is each agent's state: which one is working, which is stuck on a permission prompt, which has finished its turn. ⌘⇧J jumps to the next one waiting for you, the Agent overview shows them all on one screen where you can reply and hand out tasks, and agents return to the same conversation after a relaunch.

会改我的 Agent 配置吗?Does it change my agent settings?

不会。Claude Code 的 hooks 在启动时用 --settings 传进去,不碰你的设置文件。Codex 和 Grok 的状态 hook 要你自己打开,它只写一份 Waitlight 自己的文件,关掉就删除。No. Claude Code's hooks are passed with --settings at launch, without touching your settings files. The status hooks for Codex and Grok are opt-in; turning one on writes a single file of Waitlight's own, and turning it off deletes it.

会收集我的数据吗?Does it collect any data?

不会。Waitlight 没有统计和遥测,唯一主动的联网是检查更新时读取 GitHub Releases。No. There is no analytics or telemetry. The only connection Waitlight makes on its own is checking GitHub Releases for updates.

下载Download

合用就拿去。Take it if it fits.

这是照着一个人自己的工作流做的,开源出来。可以从 Releases 下载签过名的包,也可以自己构建。

Built for one person's workflow, and open-sourced in case it fits yours. Download a signed build from Releases, or build it yourself.

AgentAgents
内置 12 个主流 CLI,装了哪些列哪些12 mainstream CLIs built in, listed once installed
系统System
macOS 14 或更高macOS 14 or later
芯片Chip
目前只有 Apple 芯片Apple silicon only, for now
远程采样Remote stats
目前只支持 LinuxLinux only, for now
许可License
MIT。终端引擎是 GhosttyMIT. The terminal engine is Ghostty
从源码构建Build from source

需要 macOS 14 或更高、Xcode 16 或更高、XcodeGen,以及 Zig(版本看 vendor/ghostty/build.zig.zon 里的 minimum_zig_version)。

You need macOS 14 or later, Xcode 16 or later, XcodeGen, and Zig (the version named by minimum_zig_version in vendor/ghostty/build.zig.zon).

git clone --recursive https://github.com/CassianFlorin/Waitlight.git
cd Waitlight
scripts/build-ghosttykit.sh      # 构建 GhosttyKit,第一次约 5 分钟builds GhosttyKit, about 5 minutes the first time
scripts/fetch-sparkle.sh         # 下载 Sparkle 更新框架downloads the Sparkle updater
xcodegen
open Waitlight.xcodeproj

Debug 配置是 ad-hoc 签名,不需要证书。Xcode 26 及以后,Metal 编译器是单独的组件,装一次就行:

The Debug configuration is ad-hoc signed, so no certificate is needed. On Xcode 26 and later the Metal compiler is a separate component; install it once:

xcodebuild -downloadComponent MetalToolchain

如果 Zig 自己下载依赖失败(走 HTTP 代理时报 400,或者报 hash mismatch、DirNotEmpty),先用 curl 把依赖取下来,再离线构建:

If Zig fails to fetch its dependencies (a 400 behind an HTTP proxy, or hash mismatch / DirNotEmpty), fetch them with curl first and build offline:

scripts/prefetch-zig-deps.sh
ZIG_SYSTEM_DIR=vendor/zig-deps/pkg scripts/build-ghosttykit.sh

构建被打断之后报 hash mismatch,用 CLEAN=1 scripts/build-ghosttykit.sh 重来。

For a hash mismatch after an interrupted build, run CLEAN=1 scripts/build-ghosttykit.sh.