golder-cli.pages.dev · Go · MIT

桌面、Android 与终端的 AI 编码助手

Golder 是用 Go 编写的开源 AI 编码助手。用原生 GUI 管理项目、对话、工具和审批;用 Android 原生 App 在手机上运行共享 Agent、构建并安装 APK;用终端工作区并排运行 agent、shell 和浏览器;也可以用 CLI、REPL 或无头模式接入已有工作流。

$curl -fsSL https://golder-cli.pages.dev/install.sh | sh
这是 CLI 安装命令;桌面版请点击上方按钮选择。浏览器功能可使用本机安装的 Chrome 或 Chromium。

从界面到 Agent:Golder 如何工作

一张图看清桌面、Android、终端、模型、工具和权限边界之间的关系。

Golder 系统架构图:GUI、Android、终端与 CLI 连接 Agent 运行时、模型、工具、Android CI、Android App 控制和安全边界
架构概览为简化示意;具体权限和平台支持以实际工具及配置为准。
Golder workspace 真实会话:agent、后端 shell 和浏览器并排工作
TUI 工作区 agent、后端 shell 和浏览器在同一个终端工作区。
Golder GUI:项目与会话导航、Agent 对话、审批和架构图预览
桌面 GUI 项目、会话、Agent 对话、diff 与审批。
Golder Android 主会话:Android 构建结果、Install APK 操作和上下文占用
Android 主会话 同一套 Agent 核心在手机上通过 JNI 运行;构建结果可直接 Install APK,上下文占用会在重开 App 后恢复。 Android 演示:GitHub Actions 构建成功、Install APK 操作和 6% 上下文占用。
终端工作区 — 浏览器与后端协作
真实录制:agent 在同一工作区开发、验证后端并操作浏览器(3 分 31 秒,4 倍速)。

01 / 选择入口

原生 GUI、Android App、终端 TUI / REPL、CLI 和 workspace 使用同一个 Agent 核心;Android 通过 JNI 接入,workspace 的 daemon 与 agent pane 是独立进程。

02 / Agent 循环

运行时组装上下文、调用所选模型、执行工具并继续对话;会话、压缩与记忆帮助任务延续。

03 / 能力与边界

文件、Git、Shell、Web、MCP、Skills 和 Android 构建/下载/安装工具连接本地与外部环境;适用调用经权限、审批、路径授权和沙箱处理,再访问项目、浏览器、窗口或 Android 安装包。

三步上手

桌面版和 CLI 分开安装;下面是两种入口。

先试试 Golder GUI

选择你的电脑版本下载安装。启动后选择项目,在设置中配置模型与凭证,即可通过桌面界面开始对话。

选择适合你电脑的桌面版

网站会识别操作系统并把相关选项放在前面;不会自动猜测芯片型号。

无法可靠识别当前设备,请在下方手动选择电脑系统。

正在检查最新版本的安装包;如果未加载,可通过下方按钮前往 GitHub。

Mac 适合当前系统

不知道芯片?点击屏幕左上角  →「关于本机」,查看「芯片」或「处理器」。

下载后打开 DMG,将 Golder GUI 拖入「应用程序」。需要 macOS 14 或更新版本。

Windows 适合当前系统

适用于 64 位 Intel / AMD 电脑。双击下载的安装程序。

Windows ARM 设备请先确认 x64 应用兼容性。

Linux 适合当前系统

Ubuntu / Debian 可选 .deb;其他发行版可选压缩包。请按电脑架构选择。

新版 macOS 安装包使用 Developer ID 签名并经过 Apple 公证。首次打开时,系统可能要求确认打开从互联网下载的应用;辅助功能、屏幕录制等权限提示仍可能出现。

在 GitHub 查看所有版本和文件 ↗
1

安装 CLI

CLI 在 macOS 可用 Homebrew、Linux 可用一键脚本;Windows 从 Releases 下载 CLI 的 .zip。桌面版需单独下载。

$ brew install getan/tap/golder
$ curl -fsSL https://golder-cli.pages.dev/install.sh | sh
2

配置凭证

默认网关 OpenCode 只需一个 API Key;也可指向任意 OpenAI 兼容端点,或用本地 Ollama。

$ export OPENCODE_API_KEY=...
3

在终端打开工作区

golder workspace 打开全局 default:第一格是 agent,Ctrl+b c 开 shell,浏览器由 agent 按需自己打开。Ctrl+b d 只断开客户端,daemon 和 pane 继续跑;golder workspace -s coding 从任何目录进入另一套命名会话,list / attach / stop 都按名字。已经习惯 tuios / herdr / tmux / zellij / screen 的话,直接在它的 pane 里跑 golder 单 agent 模式。

$ golder workspace
$ golder workspace -s coding   # 另一套命名会话
$ golder   # 已有复用器时:单个 agent

为什么是 golder

同一套 Agent 核心,适合桌面、Android、终端与自动化。

Android 原生 App

Kotlin/Compose 通过 JNI 运行共享 Go Agent;Keystore 保存凭据,前台服务保持后台任务,结构化 Git 与 GitHub Actions APK 构建/下载/安装都在手机上完成。

原生桌面工作台

Golder GUI 用 MyGo 原生界面呈现项目、会话、流式对话、diff 卡片和审批,配有文件与变更视图、浏览器界面和可选终端。它直接复用 Agent 核心,不是把 TUI 包在窗口里。

自带终端工作区

golder workspace 一个面板里跑 agent、shell 和浏览器(macOS / Linux 不必另装 tuios 或 kitty-browse):左边 agent 改代码,右边 shell 跑测试,焦点即输入;浏览器由 agent 自己通过 browser 工具的 open 动作起在同一工作区(profile 与 socket 都在 .golder/browser/),再通过 snapshot/click/fill/wait/console/network 操作页面;预设(debug-fullstack、data-analysis、review)一次起好后端、前端和浏览器,snapshot 把所有 pane 的上下文一次交给模型。

多 Provider 热切换,会话不绑定厂商

/provider 随时换网关,/resume 在当前 provider 上继续同一份上下文;内置 19 个会话网关,覆盖 OpenAI Chat / Responses、Anthropic Messages、Gemini 四种线上协议,也可指向任意兼容端点。

轻量 agent + 真正的安全边界

适用的工具调用受到权限模式、审批、路径授权和 OS 沙箱(sandbox-exec / bubblewrap)约束。默认读限工作区、写限项目与临时目录,工具网络按次授权;实际边界取决于平台和配置。

比 codex-cli 更容易定制

纯 Go,单语言、单二进制,没有 Node/Python 运行时;加一个工具、一个 provider 或一条审批规则,都在同一个 go build 里完成。

轻量 CLI,桌面版独立安装

CLI 为 Go 编译的独立程序;GUI 单独发布,按需提供图形界面、终端和浏览器。

扩展不必改核心:CLI / MCP / Skills

/extensions 一处管理声明式 CLI 工具、标准 MCP 服务(stdio/http,tools/prompts/resources)、旧 RPC 插件和 Skills;来源要显式信任,首次连接先看清执行程序、manifest/URL 与网络上限。外部工具的每次调用仍走同一审批门,扩展不必改核心。

更多特性

安全边界、长任务、会话管理都是内建的——这些才是每天用得到的部分。

Android 端到端构建

android_build 复用当前 commit 的成功 CI;android_download 只下载已有产物;android_install 或对话里的 Install APK 直接打开系统安装器,不需要为了安装重新构建。

Android 上的 GitHub 登录

默认使用 GitHub 设备码登录(类似 gh auth login),也可切到 Fine-grained PAT 做最小权限授权。PAT 需要 Contents、Workflows、Actions 读写;退出登录只清本机 token,撤销授权在 GitHub 完成。

桌面、终端与无头模式

原生 GUI 与 CLI 分别构建,共享 Agent 核心能力。终端可选分屏 workspace、全屏 TUI 或行式 REPL;无头 -p 和 stream-json 适合脚本与 CI。

桌面窗口与浏览器

浏览器界面使用本机安装的 Chrome 或 Chromium;其他 Chromium 内核浏览器的兼容性因产品和平台而异。Computer Use 仍在开发,可在用户选定窗口后尝试观察和操作;不同系统有权限与能力限制,Linux / Windows 后端仍需真实桌面验收。

可配置权限与风险评审

四档权限:只读 / 每次询问 / 自动 / 完全放行。需要评审的调用会结合权限模式、风险规则和模型判断处理;审批、沙箱及路径授权的具体行为以当前模式和环境为准。

操作系统级沙箱

macOS 用 sandbox-exec、Linux 用 bubblewrap:受沙箱约束的调用默认按白名单读取、写限项目与临时目录,工具网络默认关闭且按次授权。批准的越界或沙箱外执行依权限模式单独处理;Windows 等平台的支持范围不同。

凭据在发给模型前脱敏

工具输出、prompt、压缩摘要、记忆与 session 落盘前统一扫描;覆盖 AWS/GCP/Azure/GitHub/GitLab/Slack/Stripe/OpenAI/Anthropic/JWT/PEM/DB URL,支持 off / observe / redact / block 四档,审计只记规则名与 hash。写文件时才还原占位符。

长任务不掉线

/compact 压缩、上下文预算工具、/goal 自主目标循环、持久记忆与 /dream 整理——跑几小时的大活有配套的兜底;子 Agent 只在你明确要求时派发,fresh 独立上下文或 fork 继承父对话,连接中途断掉时从断点续写,不丢整轮。

会话是资产

/resume 历史会话、/fork 从任意消息分叉、/tree 浏览分支树、/rewind 把文件与对话一起回滚、/export 往返存档。会话不绑厂商:换网关后用 /resume 在当前 provider 上继续同一份上下文。

工作区会话按名字管理

golder workspace 打开全局 default,-s coding 从任何目录进入另一套;new / attach / list / status / stop / rm 都按名字。每个名字一个独立 daemon,带着自己的配置、状态和日志;连接、查询、停止不要求原项目目录还在,旧的项目级会话仍可用 legacy 选择器连接。

读取越界要先问过你

读取类工具默认只读工作区;越界会先弹窗问——只读这一次、本会话允许该目录,或记住(写进授权表,/boundary 可查)。没人可问时(无头、子 Agent)失败关闭。完全放行关掉的是审查与沙箱,不是知情同意。

跑在 tuios / herdr 里就是一个 agent

在 tuios 窗口或 herdr pane 里启动,golder 自己上报状态:rail 上出现工作 / 等你 / 完成,审批与提问进 Inbox,daemon 重启后带着 golder --resume 回到原会话。两个宿主都不用改;tuios 用 golder host-compat install 写一份 harness manifest,herdr 不需要。

网络按次授权,代理可选择

20 个内置网关,覆盖 OpenAI Chat / OpenAI Responses / Anthropic Messages / Gemini 四种线上协议,也可指向任意 OpenAI 兼容端点;网络默认关闭且按次授权——需要联网的调用在参数里声明,auto 下随评审通过的调用一起放行,ask 下与外部路径、沙箱外运行合并进同一个弹窗;没有持久化网络白名单,也没有单独的 /network 命令。/proxy 可分别选择 provider,也能用 browser on 让 Chromium pane 走同一个代理;未选中的直连、不继承 shell 的 HTTP_PROXY。

常见问题

还有别的问题?到 GitHub 提 issue。 提 issue ↗

macOS GUI 经过签名和公证了吗?

新版 macOS GUI 已使用 Developer ID 签名并经过 Apple 公证;旧版可能尚未公证。首次打开时,系统仍可能要求确认打开从互联网下载的应用;辅助功能、屏幕录制等系统授权也可能出现。请只从官方 Releases 下载,遇到其他安全告警时先确认具体原因。

需要 Node 或别的运行时吗?

运行 Golder 不需要 Node 或 Python;GUI 和 CLI 是分别发布的程序。从源码构建需要 Go,浏览器功能可使用本机 Chrome 或 Chromium,Linux GUI 还需要相应的系统图形库。

我的代码会被上传到哪里?

对话和用于完成任务的上下文会发送给你配置的模型服务;使用浏览器、网络工具或 MCP 扩展时,这些服务也可能接收相应请求。会话、记忆和凭据保存在本地,具体发送内容取决于你选择的模型、工具和授权。

支持哪些模型?

内置 20 个网关(19 个会话网关 + 审批用的决策模型 typesafe,它不接会话)。会话不绑厂商:/provider 换网关后用 /resume 继续同一份上下文,/provider default <名称> 把常用网关设为新会话默认;推理档位 off 到 max,也可以指向本地 Ollama。

安全吗?它会乱改我的文件吗?

三道门:静态硬拒(sudo、rm -rf /、写 ~/.ssh 与凭据路径直接拒绝,凭据永远不可授权)→ 逐调用审查(auto 档每次改动型调用都过决策模型,拿不准升级给会话模型:低风险放行、需隔离的进沙箱、高危拒绝,各给一行理由)→ OS 沙箱(读白名单、写限项目与临时目录;网络默认关闭且按次授权,随同一次能力评审放行——没有持久化网络白名单,也没有 /network 命令)。想先观察可以切到 read-only。

国内网络能用吗?

golder 支持按 provider 配代理,国内模型直连;内置 Chromium pane 也能用 /proxy browser on 走同一个代理(下次打开 browser pane 生效)。注意本站是 Cloudflare 免费子域,少数网络下可能打不开,仓库和 Releases 始终是备选入口。

和 pi 是什么关系?

golder 是 pi 的 Go 重实现,此后独立演进,MIT 许可。

Android 上怎么登录 GitHub?

设置 → GitHub 默认选 GitHub 登录;点登录后打开 github.com/login/device 输入设备码,授权后 access token 会自动刷新。需要最小权限时切到 Fine-grained PAT,选 Contents、Workflows、Actions 为 Read and write。退出登录只删除本机 token;要撤销 GitHub 授权,用“在 GitHub 撤销授权”。

怎么更新?

跑 golder update 即自更新;重跑安装脚本也可以。