Agent HQ Installation
Summary
- - Backend + frontend: Express API with SQLite board + Vite/React UI served from
frontend-react/dist. - Automation pieces: Jarvis summary (
scripts/jarvis-connector.js), Telegram notifier (scripts/notify-jarvis-telegram.js + cron), plus a high-priority watcher inside backend/server.js. - Data:
data/board.json seeds missions/agents/cards; the board persists in data/mission.db. - Notifications:
config/telegram.json (or AGENT_HQ_TELEGRAM_* env vars) lets you send alerts to Telegram.
Setup steps
- 1. Clone the repo and install deps:
git clone https://github.com/thibautrey/agent-hq.git
cd agent-hq
npm install
npm --prefix frontend-react install
- 2. Edit
config/telegram.json with your botToken/chatId (or set AGENT_HQ_TELEGRAM_TOKEN/AGENT_HQ_TELEGRAM_CHAT_ID). Keep this file secret. - Build the UI and start the server:
npm --prefix frontend-react run build
npm run start:agent-hq
The UI is served on
/ and the API lives under
/api (default port 4000).
- 4. Configure cron jobs (Heartbeats + Telegram):
- Jarvis summary:
node scripts/jarvis-connector.js or
scripts/notify-jarvis-telegram.js --force as needed.
- Telegram notifier cron (see
run-telegram-notifier.sh).
- 5. Use the UI to create cards or
POST /api/cards//api/cards/quick to keep Jarvis busy.
Runtime commands
- - View board: INLINECODE20
- Trigger Telegram alert: INLINECODE21
- Quick card: INLINECODE22
- Jarvis summary: INLINECODE23
Tips
- - Drop cards directly into
data/board.json before first run for a seeded mission. - INLINECODE25 table in SQLite prevents duplicate Telegram alerts.
- INLINECODE26 protects mutating endpoints for scripted integrations.
Release notes
- - 2026-02-09 – Mission-control stack created, README translated to English, changelog added, and the Clawdhub installer skill
agent-hq@1.0.0 published (now mirrored with this manifest).
Enjoy running your own Mission Control.
Agent HQ 安装指南
概述
- - 后端 + 前端：基于 Express API 和 SQLite 数据库，前端使用 Vite/React 构建，部署在 frontend-react/dist 目录。
- 自动化组件：Jarvis 摘要（scripts/jarvis-connector.js）、Telegram 通知（scripts/notify-jarvis-telegram.js + cron 定时任务），以及 backend/server.js 中的高优先级监控模块。
- 数据：data/board.json 用于初始化任务/代理/卡片数据；任务数据持久化存储在 data/mission.db 中。
- 通知：通过 config/telegram.json（或 AGENTHQTELEGRAM_* 环境变量）配置 Telegram 告警发送。
安装步骤
- 1. 克隆仓库并安装依赖：
bash
git clone https://github.com/thibautrey/agent-hq.git
cd agent-hq
npm install
npm --prefix frontend-react install
- 2. 编辑 config/telegram.json，填入你的 botToken 和 chatId（或设置 AGENTHQTELEGRAMTOKEN / AGENTHQTELEGRAMCHAT_ID 环境变量）。请确保该文件保密。
- 构建前端界面并启动服务器：
bash
npm --prefix frontend-react run build
npm run start:agent-hq
前端界面通过 / 路径访问，API 接口位于 /api 路径下（默认端口 4000）。
- 4. 配置定时任务（心跳检测 + Telegram 通知）：
- Jarvis 摘要：根据需要运行 node scripts/jarvis-connector.js 或 scripts/notify-jarvis-telegram.js --force。
- Telegram 通知定时任务（参见 run-telegram-notifier.sh）。
- 5. 通过前端界面创建卡片，或使用 POST /api/cards / /api/cards/quick 接口让 Jarvis 保持忙碌。
运行时命令
- - 查看任务面板：curl http://localhost:4000/api/board
- 触发 Telegram 告警：curl -X POST http://localhost:4000/api/notify-telegram
- 快速创建卡片：curl -X POST http://localhost:4000/api/cards/quick -H Content-Type: application/json -d {text:需要设计评审}
- Jarvis 摘要：node scripts/jarvis-connector.js
使用技巧
- - 首次运行前，可直接将卡片数据放入 data/board.json 以初始化任务。
- SQLite 中的 highpriorityjobs 表用于防止重复发送 Telegram 告警。
- AGENTHQAPI_TOKEN 环境变量用于保护脚本集成中的变更接口。
版本发布说明
- - 2026-02-09 – 创建任务控制栈，将 README 翻译为英文，添加变更日志，并发布 Clawdhub 安装技能 agent-hq@1.0.0（现已通过此清单同步）。
尽情享受运行你自己的任务控制系统吧。
