agent-hue ,在做大数据的时候,曾经见过 hue 交互平台,底下有 spark hive等编译引擎,我觉得 claude code,openclaw,hermes,openclaw 都是类似 spark hive的编译引擎,所以我觉得应该有一个平台 可以交互或切换这些工具,然后也可以搞一个 agent 界的hue,我觉得大数据 hdoop的生态很值得学习
| Files | Last commit | Last 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
上下文注入策略
每次指令执行时,系统自动构建上下文:
- 最近 3 轮对话:完整注入到 prompt 中
- 3 轮以前的对话:自动生成摘要(
summary.md),控制在窗口的 1/5 以内 - 项目 context_memory.md:如果项目目录下存在此文件,自动包含
注意事项
- Claude Code 必须已安装并配置好 API Key(
claude命令可用) --permission-mode bypassPermissions:非交互模式跳过权限确认,确保指令能自动执行- 同一会话内指令串行执行:后一条指令会等待前一条完成。不同会话之间并行
- 数据持久化:会话和消息存储在
DATA_DIR/sessions/下,JSON + JSONL 格式 - Windows 开发:Go 通过 stdin 传递 prompt 给 Claude Code,避免命令行参数编码问题
- 云端 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