glad-web
v1.0.18
Published
Glad transforms terminal-based AI coding tools into a polished, mobile-friendly local Web interface.
Downloads
1,449
Maintainers
Readme
Glad 是一个面向终端 AI 编码工具的本地优先 Web 界面。
它让你可以在自己的机器上运行 Claude Code、Aider、GitHub Copilot CLI、Gemini CLI 等交互式命令行工具,并通过一个适合桌面和移动端访问的浏览器界面来使用它们。

演示视频
看看 Glad 如何将终端 AI 工具无缝带到你的移动设备上:
[!NOTE] Glad 基于 termly-cli 演化而来,但当前项目已经明确收敛为更简单的模型:本地执行、局域网访问、以及围绕终端 AI 工具的轻量 Web UI。
工作原理
Glad 的核心工作原理:
- Glad 运行在你装好 Claude、Codex、Aider 等终端工具的服务器上。
- 启动 Glad 后,在本机和局域网可通过 3000 端口访问。
- 如果使用 Tailscale 或者 ZeroTier 做了内网穿透,就可以进行远程操控。
- 所有终端任务在本地的 Glad 守护进程中运行,不怕手机断网影响程序执行。
开发目的与设计哲学
Glad 的初衷是开发一款完全运行在本地的、足够简单的,且登录和授权完全对齐官方的工具,可以把各种 CLI “搬”到网页端。这样你就可以在移动设备上随时进行 vibe coding,不用担心包月订阅闲置,也无需担心客户端手机断联会导致电脑端的任务停止。
我们的设计哲学是:易用、稳定、克制。只提供最核心且体验优秀的功能:
- Session 管理:在一个面板中管理多个会话,每个会话可单独指定工作目录。
- 高还原度的 terminal 交互:专为手机优化的终端体验与快捷按键。
- 极致性能的历史查看:快速流畅的终端历史记录浏览。
- 简单但足够好用的改动检查:内置 Git 改动预览功能。
- 断线保护:服务端任务不受移动端网络断开影响。
- 开箱即用:一条命令启动 Web UI,自动检测多种主流 AI CLI。
- 独立二进制:支持打包 Linux、macOS 和 Windows 独立可执行文件。
快速开始
通过 npm 安装
要求:
- Node.js
>=18
npm install -g glad-web
glad安装时的 npm 包名是 glad-web,安装后的命令是 glad。
从源码运行
要求:
- Node.js
>=18
git clone https://github.com/Next2012/Glad.git
cd glad
npm install
node bin/cli.js以二进制运行
Linux:
chmod +x glad-linux-amd64
./glad-linux-amd64Windows:
直接双击 glad-windows-amd64.exe 即可运行,或者在命令提示符中执行:
glad-windows-amd64.exemacOS Intel:
chmod +x glad-macos-x64
./glad-macos-x64macOS Apple Silicon:
chmod +x glad-macos-arm64
./glad-macos-arm64使用方式
Glad 默认在本机 3000 端口启动 Web 服务。
- 打开
http://localhost:3000 - 点击
+ New - 按需填写工作目录
- 选择一个已安装的 AI 工具
- 在浏览器里启动并使用会话
常用命令:
glad
glad /path/to/project
glad . --port 8080
glad tools list
glad tools detect支持的工具
Glad 当前会自动检测代码注册表中定义的 21 个终端 AI 工具。下面的名称严格使用 Glad 注册表里的 displayName:
| 工具 | 检测命令 |
| --- | --- |
| Claude | claude |
| Aider | aider |
| Codex | codex |
| Copilot | copilot |
| Cody | cody chat |
| Gemini | gemini |
| Antigravity | agy |
| Continue | cn |
| Cursor | cursor-agent |
| ChatGPT | chatgpt |
| ShellGPT | sgpt --repl temp |
| Mentat | mentat |
| Grok | grok |
| Ollama | ollama run codellama |
| OpenHands | openhands |
| OpenCode | opencode |
| Blackbox AI | blackboxai |
| Amazon Q | q |
| Pi | pi |
| Kilo | kilo |
| Qoder | qodercli |
Glad 还内置了用于测试的 demo 工具,但 demo 模式不计入自动检测列表。
打包
构建 Linux 独立二进制:
npm run build:linux构建 Windows 独立二进制:
npm run build:windows在 Intel macOS runner 上构建 macOS Intel 独立二进制:
npm run build:macos:x64在 Apple Silicon macOS runner 上构建 macOS Apple Silicon 独立二进制:
npm run build:macos:arm64构建后会分别生成 glad-linux-amd64、glad-windows-amd64.exe、glad-macos-x64 和 glad-macos-arm64 文件。GitHub release workflow 会在 macos-15-intel 构建 macOS Intel 版本,并在 macos-14 构建 macOS Apple Silicon 版本。
安全模型
Glad 面向受信任的本机或局域网环境使用。
- 服务进程运行在你的机器上
- 终端 I/O 保留在本机
- 浏览器 UI 直接与本地 Glad 进程通信
如果没有额外访问控制,不建议直接暴露到公网。
更多说明见 SECURITY.md。
开源协议
本项目使用 MIT 协议,由 next2012 维护。
