gh
grf-harness
零依赖的终端 AI Agent
纯 Go 标准库构建的终端 AI agent harness：25 个内置工具、全屏 TUI、会话恢复、沙箱审批，支持全屏交互、单任务直出、Go 库嵌入与 OpenAI 兼容 API 四种形态。
纯 Go零依赖终端优先
全屏 TUI，一览无余
会话、工具调用、审批与目标进度都在一块终端里。终端尺寸变化自动重排，鼠标拖选即可复制。
全屏交互单任务直出Go 库嵌入Responses API 服务
gh · session a3f9deepseek-chat · steps 12/64
you ❯统计当前目录 go 文件行数，输出一份报告
gh ❯
正在扫描项目结构…
✓ glob(“**/*.go”) · 47 个文件
✓ bash(“wc -l ...”) · 沙箱已批准
✓ write(“report.md”)
完成：共 8,432 行，报告已写入 report.md
❯输入消息，/ 查看指令▍
TODO 2/3 · goal: 代码统计sandbox: workspace-write
核心能力
把细节做到位
25 个内置工具
文件读写编辑、Bash 沙箱执行、Web 搜索、子代理编排、目标管理与工作流，开箱即用。
全屏 TUI
终端尺寸变化自动重排重绘，鼠标滚轮与拖选复制（OSC52），斜杠指令直达。
会话持久化
会话自动保存到 .grf/sessions，gh -resume 随时恢复上次现场。
沙箱与审批
macOS sandbox-exec 隔离执行，敏感操作先经你确认，安全可控。
四种运行形态
全屏交互、单任务直出、作为 Go 库嵌入，或经 gh server 提供 OpenAI Responses API 兼容服务。
多提供商模型
OpenAI 兼容接口，DeepSeek 等模型即插即用，配置存于 ~/.grf/settings.json。
工作流编排
内置迷你 JavaScript 解释器，驱动多步 workflow；目标模式自动续跑直到完成。
微信接入
gh connect weixin 一键连接 ClawBot，把 Agent 能力带进聊天窗口。
快速开始
几条命令，即刻上手
$
git clone https://git.gorun.fun/share/grf-harness.git获取源码$
go build -o gh .构建（或 ./build.sh）$
gh进入全屏交互$
gh -resume恢复上一次会话$
gh server启动 Responses API 服务