glad-web 1.0.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2025 Termly Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,182 @@
+<div align="center">
+  <img src="./assets/logo.svg" alt="Glad Logo" width="150" height="150" />
+  <h1>Glad</h1>
+</div>
+
+Glad is a local-first Web interface for terminal-based AI coding tools.
+
+It lets you run interactive CLI tools such as **Claude Code**, **Aider**, **GitHub Copilot CLI**, and **Gemini CLI** on your machine, then access them through a clean browser UI from desktop or mobile devices on your local network.
+
+![Glad AI mobile interface](./assets/demo.jpg)
+
+### Demo Video
+
+Watch how Glad brings terminal AI tools to your mobile device seamlessly:
+
+<video src="assets/Demo.mp4" controls width="100%"></video>
+
+> [!NOTE]
+> Glad is derived from [termly-cli](https://github.com/termly-dev/termly-cli), but the current project is intentionally focused on a simpler model: local execution, local network access, and a lightweight Web UI for terminal-native AI tools.
+
+## How it works
+
+![Glad Architecture](./assets/architecture.svg)
+
+Glad's core working principle:
+1. Glad runs on your server or local machine where Claude, Codex, Aider, and other CLI tools are installed.
+2. Once started, Glad is accessible on your local machine and LAN via port 3000.
+3. If you use Tailscale or ZeroTier for intranet penetration, you can control it remotely from anywhere.
+4. All terminal tasks run locally within the Glad daemon, so your mobile device disconnecting won't affect task execution.
+
+## Design Philosophy & Highlights
+
+Glad was created to enable **vibe coding** on mobile devices. By bringing various CLIs to the web browser, login and authorization are completely aligned with the official tools, ensuring you can fully utilize your paid monthly subscriptions anywhere.
+
+Our design philosophy is **Easy to use, Stable, and Restrained**. Glad focuses strictly on the essentials:
+- **Session management:** Run multiple sessions from a single dashboard with per-session working directories.
+- **High-fidelity terminal interaction:** A mobile-friendly terminal experience with touch shortcuts.
+- **Extreme performance history viewing:** Fast and responsive text history.
+- **Simple but effective change checking:** Integrated Git changes preview.
+- **Resilient execution:** Client (mobile) disconnections will not interrupt running tasks on the host machine.
+- **Simplicity:** One-command Web UI with built-in detection for many popular AI CLIs.
+- **Standalone binaries:** Linux, macOS, and Windows standalone packaging available.
+
+## Quick Start
+
+### Run from source
+
+Requirements:
+
+- Node.js `>=18`
+
+```bash
+git clone git@gitee.com:next2012/glad.git
+cd glad
+npm install
+node bin/cli.js
+```
+
+### Run as a binary
+
+**Linux:**
+
+```bash
+chmod +x glad-linux-amd64
+./glad-linux-amd64
+```
+
+**Windows:**
+
+Simply double-click `glad-windows-amd64.exe` to run, or execute it in the Command Prompt:
+
+```cmd
+glad-windows-amd64.exe
+```
+
+**macOS Intel:**
+
+```bash
+chmod +x glad-macos-x64
+./glad-macos-x64
+```
+
+**macOS Apple Silicon:**
+
+```bash
+chmod +x glad-macos-arm64
+./glad-macos-arm64
+```
+
+## Usage
+
+Glad starts a local Web server on port `3000` by default.
+
+1. Open `http://localhost:3000`.
+2. Click `+ New`.
+3. Optionally choose a working directory.
+4. Pick an installed AI tool.
+5. Start the session from the browser UI.
+
+Useful commands:
+
+```bash
+glad
+glad /path/to/project
+glad . --port 8080
+glad tools list
+glad tools detect
+```
+
+## Supported Tools
+
+Glad currently auto-detects the 20 terminal AI tools defined in the code registry. The names below are the registry `displayName` values used by Glad:
+
+| Tool | Detected command |
+| --- | --- |
+| Claude | `claude` |
+| Aider | `aider` |
+| Codex | `codex` |
+| Copilot | `copilot` |
+| Cody | `cody chat` |
+| Gemini | `gemini` |
+| 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 also includes a built-in `demo` tool for testing, but demo mode is not included in auto-detection.
+
+## Packaging
+
+Build a Linux standalone binary with:
+
+```bash
+npm run build:linux
+```
+
+Build a Windows standalone binary with:
+
+```bash
+npm run build:windows
+```
+
+Build a macOS Intel standalone binary on an Intel macOS runner with:
+
+```bash
+npm run build:macos:x64
+```
+
+Build a macOS Apple Silicon standalone binary on an Apple Silicon macOS runner with:
+
+```bash
+npm run build:macos:arm64
+```
+
+After building, `glad-linux-amd64`, `glad-windows-amd64.exe`, `glad-macos-x64`, and `glad-macos-arm64` files will be generated respectively. The GitHub release workflow builds macOS Intel on `macos-15-intel` and macOS Apple Silicon on `macos-14`.
+
+## Security Model
+
+Glad is designed for trusted local or private-network use.
+
+- the server runs on your machine
+- terminal I/O stays local to that machine
+- the browser UI talks directly to the local Glad process
+
+Do not expose Glad directly to the public internet without adding your own access controls.
+
+See [SECURITY.md](./SECURITY.md) for details.
+
+
+## License
+
+MIT. Glad is maintained by [next2012](https://gitee.com/next2012/glad).

package/README.zh-CN.md

@@ -0,0 +1,182 @@
+<div align="center">
+  <img src="./assets/logo.svg" alt="Glad Logo" width="150" height="150" />
+  <h1>Glad</h1>
+</div>
+
+Glad 是一个面向终端 AI 编码工具的本地优先 Web 界面。
+
+它让你可以在自己的机器上运行 **Claude Code**、**Aider**、**GitHub Copilot CLI**、**Gemini CLI** 等交互式命令行工具，并通过一个适合桌面和移动端访问的浏览器界面来使用它们。
+
+![Glad AI 移动端界面](./assets/demo.jpg)
+
+### 演示视频
+
+看看 Glad 如何将终端 AI 工具无缝带到你的移动设备上：
+
+<video src="assets/Demo.mp4" controls width="100%"></video>
+
+> [!NOTE]
+> Glad 基于 [termly-cli](https://github.com/termly-dev/termly-cli) 演化而来，但当前项目已经明确收敛为更简单的模型：本地执行、局域网访问、以及围绕终端 AI 工具的轻量 Web UI。
+
+## 工作原理
+
+![Glad 架构图](./assets/architecture.svg)
+
+Glad 的核心工作原理：
+1. Glad 运行在你装好 Claude、Codex、Aider 等终端工具的服务器上。
+2. 启动 Glad 后，在本机和局域网可通过 3000 端口访问。
+3. 如果使用 Tailscale 或者 ZeroTier 做了内网穿透，就可以进行远程操控。
+4. 所有终端任务在本地的 Glad 守护进程中运行，不怕手机断网影响程序执行。
+
+## 开发目的与设计哲学
+
+Glad 的初衷是开发一款完全运行在本地的、足够简单的，且登录和授权完全对齐官方的工具，可以把各种 CLI “搬”到网页端。这样你就可以在移动设备上随时进行 **vibe coding**，不用担心包月订阅闲置，也无需担心客户端手机断联会导致电脑端的任务停止。
+
+我们的设计哲学是：**易用、稳定、克制**。只提供最核心且体验优秀的功能：
+- **Session 管理**：在一个面板中管理多个会话，每个会话可单独指定工作目录。
+- **高还原度的 terminal 交互**：专为手机优化的终端体验与快捷按键。
+- **极致性能的历史查看**：快速流畅的终端历史记录浏览。
+- **简单但足够好用的改动检查**：内置 Git 改动预览功能。
+- **断线保护**：服务端任务不受移动端网络断开影响。
+- **开箱即用**：一条命令启动 Web UI，自动检测多种主流 AI CLI。
+- **独立二进制**：支持打包 Linux、macOS 和 Windows 独立可执行文件。
+
+## 快速开始
+
+### 从源码运行
+
+要求：
+
+- Node.js `>=18`
+
+```bash
+git clone git@gitee.com:next2012/glad.git
+cd glad
+npm install
+node bin/cli.js
+```
+
+### 以二进制运行
+
+**Linux:**
+
+```bash
+chmod +x glad-linux-amd64
+./glad-linux-amd64
+```
+
+**Windows:**
+
+直接双击 `glad-windows-amd64.exe` 即可运行，或者在命令提示符中执行：
+
+```cmd
+glad-windows-amd64.exe
+```
+
+**macOS Intel:**
+
+```bash
+chmod +x glad-macos-x64
+./glad-macos-x64
+```
+
+**macOS Apple Silicon:**
+
+```bash
+chmod +x glad-macos-arm64
+./glad-macos-arm64
+```
+
+## 使用方式
+
+Glad 默认在本机 `3000` 端口启动 Web 服务。
+
+1. 打开 `http://localhost:3000`
+2. 点击 `+ New`
+3. 按需填写工作目录
+4. 选择一个已安装的 AI 工具
+5. 在浏览器里启动并使用会话
+
+常用命令：
+
+```bash
+glad
+glad /path/to/project
+glad . --port 8080
+glad tools list
+glad tools detect
+```
+
+## 支持的工具
+
+Glad 当前会自动检测代码注册表中定义的 20 个终端 AI 工具。下面的名称严格使用 Glad 注册表里的 `displayName`：
+
+| 工具 | 检测命令 |
+| --- | --- |
+| Claude | `claude` |
+| Aider | `aider` |
+| Codex | `codex` |
+| Copilot | `copilot` |
+| Cody | `cody chat` |
+| Gemini | `gemini` |
+| 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 独立二进制：
+
+```bash
+npm run build:linux
+```
+
+构建 Windows 独立二进制：
+
+```bash
+npm run build:windows
+```
+
+在 Intel macOS runner 上构建 macOS Intel 独立二进制：
+
+```bash
+npm run build:macos:x64
+```
+
+在 Apple Silicon macOS runner 上构建 macOS Apple Silicon 独立二进制：
+
+```bash
+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](./SECURITY.md)。
+
+
+## 开源协议
+
+本项目使用 MIT 协议，由 [next2012](https://gitee.com/next2012/glad) 维护。

package/assets/logo.svg

@@ -0,0 +1,40 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="512" height="512">
+  <defs>
+    <linearGradient id="bgGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#151522" />
+      <stop offset="100%" stop-color="#2D2B55" />
+    </linearGradient>
+    <linearGradient id="phoneGrad" x1="0%" y1="100%" x2="100%" y2="0%">
+      <stop offset="0%" stop-color="#FF3366" />
+      <stop offset="50%" stop-color="#FF9933" />
+      <stop offset="100%" stop-color="#33CCFF" />
+    </linearGradient>
+  </defs>
+
+  <!-- Background App Icon Shape -->
+  <rect x="24" y="24" width="464" height="464" rx="104" fill="url(#bgGrad)" />
+
+  <!-- Mobile Device Outline -->
+  <rect x="126" y="66" width="260" height="380" rx="36" fill="#1A1A2E" stroke="url(#phoneGrad)" stroke-width="12" />
+  
+  <!-- Mobile screen top bar (notch/speaker) -->
+  <line x1="226" y1="96" x2="286" y2="96" stroke="url(#phoneGrad)" stroke-width="8" stroke-linecap="round" />
+
+  <!-- Left Eye: Terminal Prompt ">" -->
+  <polyline points="180,185 210,205 180,225" fill="none" stroke="#33CCFF" stroke-width="16" stroke-linecap="round" stroke-linejoin="round" />
+  
+  <!-- Right Eye: AI Sparkle -->
+  <path d="M 322 175 Q 322 205 352 205 Q 322 205 322 235 Q 322 205 292 205 Q 322 205 322 175 Z" fill="#FFD700" />
+
+  <!-- Glad Smile -->
+  <path d="M 175 265 Q 256 315 337 265" fill="none" stroke="#FF3366" stroke-width="16" stroke-linecap="round" />
+
+  <!-- Vibe Coding Waves (Audio bars) -->
+  <g stroke-linecap="round" stroke-width="10">
+    <line x1="196" y1="375" x2="196" y2="400" stroke="#FF9933" />
+    <line x1="226" y1="355" x2="226" y2="400" stroke="#FF3366" />
+    <line x1="256" y1="340" x2="256" y2="400" stroke="#33CCFF" />
+    <line x1="286" y1="360" x2="286" y2="400" stroke="#FFD700" />
+    <line x1="316" y1="380" x2="316" y2="400" stroke="#FF9933" />
+  </g>
+</svg>

package/bin/cli.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+
+const { Command } = require('commander');
+const chalk = require('chalk');
+const packageJson = require('../package.json');
+
+// Import commands
+const webCommand = require('../lib/commands/web');
+const toolsCommand = require('../lib/commands/tools');
+const configCommand = require('../lib/commands/config');
+
+const program = new Command();
+
+// Configure program
+program
+  .name('glad')
+  .description('Transform your AI terminal tools into a beautiful Web interface')
+  .version(packageJson.version, '-v, --version', 'Show version');
+
+// Default Web command
+program
+  .command('web [directory]', { isDefault: true })
+  .description('Start the local web server to access AI tools')
+  .option('-p, --port <number>', 'Port to run the server on', '3000')
+  .action(async (directory, options) => {
+    await webCommand({ ...options, directory });
+  });
+
+// Tools command
+program
+  .command('tools <action> [tool-name]')
+  .description('Manage AI tools (actions: list, detect, info)')
+  .action(async (action, toolName) => {
+    await toolsCommand(action, toolName);
+  });
+
+// Config command
+program
+  .command('config [action] [key] [value]')
+  .description('Manage configuration (actions: get, set)')
+  .action(async (action, key, value) => {
+    await configCommand(action, key, value);
+  });
+
+// Help command customization
+program.on('--help', () => {
+  console.log('');
+  console.log('Quick Start:');
+  console.log('  $ glad                                  # Start web server in current folder');
+  console.log('  $ glad /path/to/project                 # Start in specific folder');
+  console.log('  $ glad . --port 8080                    # Custom port in current folder');
+  console.log('');
+  console.log('Manage Tools:');
+  console.log('  $ glad tools list                       # List all supported tools');
+  console.log('  $ glad tools detect                     # Check installed tools');
+  console.log('');
+  console.log('Supported AI Tools:');
+  console.log('  • Claude Code, Aider, GitHub Copilot, Gemini CLI, and more...');
+  console.log('');
+  console.log('Source: https://gitee.com/next2012/glad');
+  console.log('');
+});
+
+// Parse arguments
+program.parse(process.argv);