关于 Giljo HQ
Giljo HQ 是面向 AI 辅助软件开发的可自托管上下文与协作服务,适用于开发者和产品经理。它整理产品背景、项目任务和累积记忆,但不编写代码或调用 AI 模型。
主要功能
- 01保存产品和项目背景
- 02组装结构化任务提示词
- 03协调多 Agent 工作流
- 04保存并搜索 360 Memory
- 05监控 Agent 活动和消息
- 06自定义 Agent 模板
适用场景
- 01为编码会话提供共享产品背景
- 02安排并排序项目工作
- 03将决策和结果传递到后续项目
- 04跨会话跟踪 Agent 进度
MCP 相关
Giljo HQ 通过 HTTP MCP 服务提供上下文和协作数据,包含 54 个 MCP 工具。MCP 客户端读取这些数据,并使用各自的 AI 进行推理和编码。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://app.giljo.ai/mcpclaude mcp add --transport http ai-giljo-hq https://app.giljo.ai/mcp{"mcpServers":{"ai-giljo-hq":{"type":"http","url":"https://app.giljo.ai/mcp"}}}在 Cursor 中打开{"servers":{"ai-giljo-hq":{"type":"http","url":"https://app.giljo.ai/mcp"}}}在 VS Code 中打开{"mcpServers":{"ai-giljo-hq":{"type":"http","url":"https://app.giljo.ai/mcp"}}}{"mcpServers":{"ai-giljo-hq":{"serverUrl":"https://app.giljo.ai/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
面向 AI 辅助软件开发的上下文工程平台。
只需定义一次产品。每个连接的 Agent 都能全面了解它。
免费社区版 · 自托管 · 隐私优先 · 自带 AI
适用于: Claude Code CLI · Claude.ai / Desktop · Codex CLI · ChatGPT.com · 任意 MCP 客户端
Staging 视图:写下你想完成的工作。GiljoAI 会生成任务说明,并从你的模板中分配 Agent。
Giljo HQ 是什么
Giljo HQ 是 GiljoAI 推出的产品,为 AI 编码工具提供被动式上下文服务。它存储你的产品知识、生成结构化提示词,并通过 Model Context Protocol(MCP)协调多 Agent 工作流。它不会编写代码,也不会调用任何 AI 模型。你的 AI 编码工具会使用你自己的订阅完成所有推理和编码。
GiljoAI 位于产品思维与开发的交汇处。无论你是希望学习如何在构建之前先定义产品的开发者,还是要将规格说明转化为可运行软件的产品经理,这个平台都能为你提供从愿景到执行的结构化路径。产品定义越清晰,每次 Agent 会话就越有效。
自带 AI。 GiljoAI 适用于 Claude Code CLI、Claude.ai / Desktop、Codex CLI、ChatGPT.com 或任何兼容 MCP 的工具。在 Hosted 版本中,大多数工具只需通过浏览器一键登录即可连接;终端工具也可以使用 API 密钥,而 Community Edition 的 Connect 标签页会提供该密钥。你可以同时运行多个工具。
## 快速入门
Windows(PowerShell):
irm giljo.ai/install.ps1 | iex
Linux / macOS:
curl -fsSL giljo.ai/install.sh | bash
安装程序会检查先决条件、下载最新版本、设置数据库、构建前端,并引导你完成配置。完成后,运行 python startup.py 启动服务。首次运行时,浏览器会打开设置向导。
手动安装(高级)
git clone https://github.com/giljoai/giljo-hq.git
cd giljo-hq
python install.py
python startup.py
需要 Python 3.12+、PostgreSQL 18+、Node.js 22.23.3+。
使用 VS Code? 此代码仓库附带一个 .vscode/mcp.json,指向你本地的
Giljo HQ 安装(http://localhost:7272/mcp)——打开文件夹后,VS Code 的
MCP 集成会自动识别它。无需复制粘贴连接命令。
六大支柱
你的工具,你的订阅
GiljoAI 绝不会动用你的 AI 额度。你可以自带 Claude Code CLI、Claude.ai / Desktop、Codex CLI、ChatGPT.com 或任何兼容 MCP 的工具,并使用自己的订阅。GiljoAI 作为被动式 MCP 服务运行:你的工具通过 HTTP 连接,读取上下文和协作数据,并自行完成推理和编码。
定义你的产品
创建一个产品来代表你正在构建的软件。填写上下文字段:描述、技术栈、架构、测试策略等。上传愿景文档,让 AI 工具自动填充这些字段。愿景文档是你能提供给 GiljoAI 的最重要输入。一份编写完善的产品提案,能让每次 Agent 会话都对你正在构建什么以及原因有共同理解。
路线图
路线图将产品中未激活的项目和待处理任务整合为一份按优先级排序的计划。每个条目都带有风险和复杂度评分,让你了解接下来哪些事项可以放心处理,哪些需要先仔细考虑。拖动即可重新排序。直接从路线图激活项目即可进行暂存,GiljoAI 会像在仪表板的其他位置一样为其组装引导提示词。若某项任务最终比预期更大,只需一步即可将其转换为项目,并保留其在看板上的位置。
项目与任务
- 创建项目并描述需要完成的工作。
- 激活项目。GiljoAI 会根据你的产品上下文、360 Memory 和项目描述组装引导提示词。
- 将提示词粘贴到你的命令行工具中。编排器会规划任务并启动 Agent。
- Agent 会实时报告状态。你可以在 Jobs 页面上监控进度。
- 项目完成后,GiljoAI 会写入一条 360 Memory 记录。下一个项目会继承这些累积的上下文。
技能与 Agent 模板
设置期间会在你的机器上安装一个技能。你可以在命令行中使用它而不中断工作流:
| 技能 | Claude Code | Codex CLI | 功能 |
|---|---|---|---|
| 项目与任务 | /giljo | $giljo | 记录任务、创建或更新项目,并在会话中途查找项目——一个命令即可处理创建和读取 |
Agent 模板完全无需安装。仪表板中的 Agent Template Manager 可让你自定义 Agent 配置,包括角色、专长和链式策略;编排器启动的每个 Agent 开始工作时,服务都会为其提供专属配置文件,其中包含角色、指令、规则和成功标准。编辑后会立即应用于你启动的下一个 Agent。如需自行运行 Agent,可从其行菜单中选择 下载配置文件(.md),再将 Markdown 文件放入任意工具中。
360 Memory
每个已完成的项目都会自动写入 360 Memory:构建了什么、关键决策、发现的模式,以及哪些做法有效。这不是插件,而是产品的核心行为。下一个项目开始时,就能利用之前项目积累的上下文。你可以通过上下文设置控制 Agent 回溯读取多少条记忆。还可以选择用 git 提交历史丰富记忆。搜索摘要、结果和决策,或按标签或项目筛选,查找之前发生的事情。
仪表板与监控
Jobs 页面会实时显示 Agent 活动:状态、步骤进度、耗时和等待中的消息。消息编辑器让你可以直接与协调器交流,或向整个 Agent 团队广播消息。所有消息都会记录在 MCP 消息系统中,以便审计。
消息中心
消息中心供 Agent 跨会话和跨机器协调使用:其中包含持久化线程、参与者、消息,以及用于跟踪轮到谁的接力标记。使用不同命令行工具或不同机器的 Agent 可以加入同一线程,并从其他 Agent 离开的地方继续工作。线程的仪表板视图是供你查看的审计记录。此处显示的任何内容都不会自动提取回 Agent 的上下文中。
版本
这是 Giljo HQ Community Edition,依据 Elastic License 2.0 免费供单用户使用。
| Community Edition(免费) | SaaS Edition |
|---|---|
| 在自己的机器上可自托管 | 托管服务:无需安装 |
| 完整的上下文组装和 Agent 协调 | 包含 CE 的所有功能,另加: |
| 6 个 Agent 模板 + 自定义 | 使用 Google 或 GitHub 登录 |
| 实时仪表板与监控 | 可下载或还原的每夜加密备份 |
| 项目数量不限,最多 16 个活动 Agent 槽位 | 自助式 Solo 订阅与账单管理 |
| 无遥测数据,无云端依赖 | 托管更新:始终使用最新版本 |
技术栈
| 层 | 技术 |
|---|---|
| 后端 | Python 3.12+、FastAPI、SQLAlchemy 2.1(异步)、Alembic |
| 数据库 | PostgreSQL 18(必需) |
| 前端 | Vue 3(Composition API)、Vuetify 4、Vite |
| 实时通信 | 通过 PostgresNotifyBroker 使用 WebSocket |
| 身份验证 | JWT httpOnly cookies、CSRF 双重提交 |
| 协议 | 基于 HTTP 的 Model Context Protocol(MCP) |
架构
Production (single port):
Browser --> :7272 (FastAPI) --> API + WebSocket + MCP + Static files
--> PostgreSQL (localhost:5432)
Development (two ports):
Browser --> :7274 (Vite HMR) --> proxies /api, /ws, /mcp --> :7272 (FastAPI)
--> PostgreSQL (localhost:5432)
数据库始终在 localhost 上运行。所有连接都必须通过身份验证。每个查询都会在数据库层强制执行多租户隔离。
安装选项
python install.py # Production install (recommended)
python install.py --dev # Developer install (adds pre-commit hooks, NLTK data)
python install.py --headless # Non-interactive mode for CI/CD
python startup.py # Auto-detect mode and start
python startup.py --dev # Development mode with Vite hot-reload
python startup.py --setup # Re-run the Setup Wizard
python startup.py --no-browser # Start without opening the browser
python startup.py --verbose # Detailed logging
| 模式 | 端口 | 使用场景 |
|---|---|---|
| 生产环境 | 单个端口 7272 | 运行产品的用户 |
| 开发环境 | API 7272 + 前端 7274 | 修改代码的贡献者 |
文档
| 文档 | 说明 |
|---|---|
| 用户指南 | 从代码检查出发,介绍每个页面和功能 |
| 产品概览 | 产品是什么、面向谁,以及六大支柱 |
| 入门指南 | 安装后的操作指南,从设置向导到第一个项目 |
| 安装指南 | 完整的安装参考 |
| MCP 工具参考 | 全部 54 个 MCP 工具及其参数和返回值 |
| 架构 | 系统设计、网络拓扑和组件概览 |
API 文档在运行时提供:Swagger UI 位于 /docs,ReDoc 位于 /redoc。
## 安全
- 所有连接都必须进行 JWT 身份验证(不允许基于 IP 绕过)
- 使用 bcrypt 哈希密码(成本因子为 12),密码长度至少为 12 个字符
- 使用 4 位数的恢复 PIN 自助重置密码(无需电子邮件)
- 数据库始终仅在 localhost 上运行,绝不暴露到网络
- 默认使用纯 HTTP;可在“设置 → 网络”中选择启用 HTTPS(自备证书)
- 每次数据库查询都进行多租户隔离
- 对身份验证端点进行速率限制
支持
- 问题反馈: github.com/giljoai/giljo-hq/issues
- 网站: giljo.ai
- 许可证: Elastic License 2.0
- 贡献: 请参阅 CONTRIBUTING.md
Giljo HQ 由 GiljoAI 构建。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。