agent-hue:基于 Go 与 Claude Code 的 AI 代码交互平台项目

agent-hue ,在做大数据的时候,曾经见过 hue 交互平台,底下有 spark hive等编译引擎,我觉得 claude code,openclaw,hermes,openclaw 都是类似 spark hive的编译引擎,所以我觉得应该有一个平台 可以交互或切换这些工具,然后也可以搞一个 agent 界的hue,我觉得大数据 hdoop的生态很值得学习

Branch1Tags0
FilesLast commitLast update
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago

Agent-Hue

AI Agent 交互平台 —— 一个管理 Claude Code 会话的 Web 操作台。

类比 Hadoop 生态:Hue : Hive = Agent-Hue : Claude Code
Hue 提供了 SQL → MapReduce 的交互界面,Agent-Hue 提供了自然语言 → Claude Code 的交互界面。

功能

  • 会话管理:创建/关闭多个 Agent 会话,会话独立运行,关闭浏览器不影响
  • 实时流式输出:WebSocket 推送 Claude Code 执行过程,逐行可见
  • 多项目支持:不同项目目录隔离,会话可自由切换项目
  • 上下文记忆:自动注入最近 3 轮对话 + 更早对话的压缩摘要
  • 语音输入:浏览器端 Web Speech API(云端 STT 接口预留)
  • REST API:curl / 快捷指令 / 脚本均可调用
  • Agent 抽象层:后续可接入 OpenCode、Codex 等其他 Agent 后端

环境要求

  • Go 1.22+
  • Claude Code CLI(claude 命令可用)
  • Anthropic API Key(Claude Code 已配置好的环境)

快速开始

# 克隆
git clone https://gitcode.com/sengoku1237/agent-hue.git
cd agent-hue

# 安装依赖(国内网络设置代理)
go env -w GOPROXY=https://goproxy.cn,direct
go mod download

# 编译
go build -o agent-console .

# 创建项目目录
mkdir -p workspace/my-project

# 启动(Windows PowerShell)
$env:PROJECTS_DIR = "D:\your-path\workspace"
.\agent-console.exe

# 启动(Linux / macOS)
PROJECTS_DIR=/opt/workspace ./agent-console

打开浏览器访问 http://localhost:3000。

环境变量

变量 默认值 说明
PORT 3000 HTTP 服务端口
DATA_DIR ./data 会话数据存储目录
PROJECTS_DIR ./projects 项目根目录(子目录各自是一个项目)
WEB_DIR ./web 前端静态文件目录

项目目录结构

workspace/                   # PROJECTS_DIR 指向这里
├── shopping-cart/           # 项目 A(子目录名 = 项目名)
│   ├── CLAUDE.md            # 项目级 Claude 约束
│   └── context_memory.md    # 可选,跨会话的记忆文件
├── admin-dashboard/         # 项目 B
└── ...
  • 每个子目录是一个独立项目
  • CLAUDE.md 会在 Claude Code 执行时自动加载
  • context_memory.md 会被注入到每次指令的上下文中

API 接口

# 会话管理
POST   /api/sessions              # 创建会话  {"name": "..."}
GET    /api/sessions              # 列出所有会话
GET    /api/sessions/:id          # 获取会话详情
DELETE /api/sessions/:id          # 关闭会话

# 发送指令(核心)
POST   /api/sessions/:id/messages # 发送指令  {"content": "...", "project_dir": "..."}
                                  # 返回 202,后台异步执行
GET    /api/sessions/:id/messages # 获取会话消息历史

# 语音(Phase 1 stub,接口就位未接通)
POST   /api/sessions/:id/voice    # 上传音频文件

# 查询
GET    /api/projects              # 列出可用项目
GET    /api/agents                # 列出可用 Agent 后端

# WebSocket(实时流)
WS     /ws/sessions/:id           # 订阅会话的实时执行输出

curl 示例

# 创建会话
curl -X POST http://localhost:3000/api/sessions \
  -H "Content-Type: application/json" \
  -d '{"name": "修复Bug"}'

# 发送指令
curl -X POST http://localhost:3000/api/sessions/{session_id}/messages \
  -H "Content-Type: application/json" \
  -d '{"content": "在 src/api 目录下创建一个 health check 接口", "project_dir": "/opt/workspace/my-project"}'

# 查询结果
curl http://localhost:3000/api/sessions/{session_id}/messages

上下文注入策略

每次指令执行时,系统自动构建上下文:

  1. 最近 3 轮对话:完整注入到 prompt 中
  2. 3 轮以前的对话:自动生成摘要(summary.md),控制在窗口的 1/5 以内
  3. 项目 context_memory.md:如果项目目录下存在此文件,自动包含

注意事项

  1. Claude Code 必须已安装并配置好 API Key(claude 命令可用)
  2. --permission-mode bypassPermissions:非交互模式跳过权限确认,确保指令能自动执行
  3. 同一会话内指令串行执行:后一条指令会等待前一条完成。不同会话之间并行
  4. 数据持久化:会话和消息存储在 DATA_DIR/sessions/ 下,JSON + JSONL 格式
  5. Windows 开发:Go 通过 stdin 传递 prompt 给 Claude Code,避免命令行参数编码问题
  6. 云端 STT 接口:POST /api/sessions/:id/voice 已就位但为 stub,收到音频不转译

架构

浏览器 (Alpine.js SPA)
    │  REST API + WebSocket
    ▼
Go 后端 (net/http + gorilla/websocket)
    │  stdin/stdout
    ▼
Claude Code CLI (claude --print)
    │  Anthropic API
    ▼
Claude / DeepSeek (via LiteLLM proxy)

License

MIT

Introduction

agent-hue ,在做大数据的时候,曾经见过 hue 交互平台,底下有 spark hive等编译引擎,我觉得 claude code,openclaw,hermes,openclaw 都是类似 spark hive的编译引擎,所以我觉得应该有一个平台 可以交互或切换这些工具,然后也可以搞一个 agent 界的hue,我觉得大数据 hdoop的生态很值得学习

Customize your domain