@yancyyu/openhermit 1.5.8

package/README.md

@@ -0,0 +1,220 @@
+<p align="center">
+  <img src="resources/icons/png/1024x1024.png" alt="openHermit" width="100" />
+</p>
+
+<h1 align="center">openHermit</h1>
+
+<p align="center">
+  <strong>一人公司的 AI 团队指挥台</strong><br/>
+  你是老板，AI 是员工，openHermit 是你的 ERP。
+</p>
+
+<p align="center">
+  <a href="https://github.com/yancyuu/Hermit/releases/latest"><img src="https://img.shields.io/github/v/release/yancyuu/Hermit?style=flat-square&label=version&color=blue" alt="最新版本" /></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0-blue?style=flat-square" alt="许可证" /></a>
+</p>
+
+---
+
+## 你是 OPC / TPC 吗？
+
+**OPC（One-Person Company）/ TPC（Two-Person Company）** — 一两个人做出过去需要整支团队才能完成的产品。
+
+这不是梦想，这正在发生。Claude Code、Codex、Gemini、Cursor、Qoder……这些 AI Coding Agent 已经可以独立完成需求分析、代码实现、测试、部署的完整链路。
+
+**但问题来了：你同时开着 10 个终端，不停地切换窗口、复制粘贴上下文、记住哪个 Agent 在做什么——这还是在"管人"。**
+
+openHermit 解决这个问题。
+
+---
+
+## openHermit 是什么
+
+openHermit 是一个 **AI 团队任务指挥台**，以 cc-connect 为引擎，让你像老板一样管理由 AI 组成的团队：
+
+- **你创建任务，AI 自动认领并执行**，结果写回看板
+- **不同 Agent 各司其职**，Claude Code 写代码、Gemini 做调研、Codex 跑测试
+- **跨团队协作自动路由**，任务分配给哪个团队，消息立刻推过去
+- **定时任务一键调度**，不用盯着
+- **飞书/微信/Telegram 渠道统一接入**，随时查看进展、发指令
+
+你做决策，AI 做执行。
+
+---
+
+## 与竞品的核心差异
+
+| | openHermit | 普通 AI IDE 插件 | 自建脚本 |
+|---|---|---|---|
+| **理念** | AI 员工团队 | 辅助写代码 | 定制化自动化 |
+| **Harness 支持** | 几乎全覆盖（见下表） | 单一 | 手写对接 |
+| **渠道接入** | 飞书/微信/Telegram/Bridge | ❌ | 手写 |
+| **多团队协作** | 任务自动路由 + MCP | ❌ | 手写 |
+| **任务追踪** | 看板 + 状态机 | ❌ | ❌ |
+| **上手成本** | 创建团队即用 | 低 | 极高 |
+| **一人公司适配** | 专为此设计 | 不适合 | 勉强 |
+
+---
+
+## 支持市面上几乎所有 Harness
+
+cc-connect 管理 Agent 运行时，openHermit 通过它驱动以下全部 harness：
+
+| Harness | 标识 | MCP 自动注入 | 适合场景 |
+|---|---|---|---|
+| **Claude Code** | `claudecode` | ✅ 自动 | 全能型编码，最强上下文 |
+| **Qoder** | `qoder` | ✅ 自动 | Claude Code 的增强版 |
+| **Codex** | `codex` | 手动配置 | OpenAI 生态，o系列推理 |
+| **Gemini** | `gemini` | 手动配置 | Google 生态，长上下文分析 |
+| **OpenCode** | `opencode` | 手动配置 | 多 provider 开源方案 |
+| **Cursor** | `cursor` | 手动配置 | IDE 深度集成 |
+| **Kimi** | `kimi` | 手动配置 | 国产长文档处理 |
+
+**新 harness 不需要改 openHermit 代码** — cc-connect 对接，openHermit 自动列出。
+
+---
+
+## 支持几乎所有渠道
+
+同一个团队可以同时接入多个渠道，你从哪里发消息都能收到回复：
+
+| 渠道 | 场景 |
+|---|---|
+| **飞书** | 企业级，支持消息卡片 |
+| **微信** | 个人/小团队最顺手 |
+| **Telegram** | 海外 / 技术向首选 |
+| **Bridge** | 跨团队内部通信（openHermit 内置） |
+
+---
+
+## 它帮你做什么
+
+### 1. 任务看板 — 你的 AI 工单系统
+
+```
+你：在看板里创建一个任务 "重构支付模块"，assignee → backend-team
+    ↓
+openHermit：自动推消息给 backend-team 的 Agent
+    ↓
+Agent：用 MCP 认领任务，开始执行
+    ↓
+完成后：结果写回看板，状态变 done，你在看板里一眼看到
+```
+
+### 2. 多团队 — 分工协作，各尽其能
+
+```
+前端团队 (Claude Code)  ——→  你的产品界面
+后端团队 (Codex)        ——→  API 和业务逻辑
+测试团队 (Gemini)       ——→  自动化测试和 QA
+调研团队 (Kimi)         ——→  竞品分析、文档整理
+```
+
+每个团队独立运行，任务可以跨团队分配，互不干扰。
+
+### 3. 定时任务 — 你的 AI 会自己上班
+
+在 openHermit 里配置定时计划，Agent 按时执行：早报、日报、代码健康检查、数据拉取……你睡觉，Agent 在跑。
+
+### 4. MCP 零配置接入
+
+Claude Code / Qoder 类 harness 创建团队时自动注入 MCP 配置，Agent 立刻拥有任务工具：
+
+```
+list_tasks    — 看自己有哪些任务
+claim_task    — 认领任务，开始干活
+complete_task — 完成任务，写入结果
+create_task   — 创建新任务分配给其他团队
+```
+
+---
+
+## 架构
+
+```
+你的指令 / 飞书消息 / 微信消息 / Telegram
+              ↓
+         cc-connect
+    （渠道接入 + Agent 进程管理）
+              ↓
+           openHermit
+    （团队管理 + 任务路由 + 看板 UI）
+              ↓
+      MCP Server（hermit-tasks）
+              ↓
+  Claude Code / Codex / Gemini / Qoder / ...
+```
+
+openHermit 本身是 **纯本地、无 SaaS、无月费**。cc-connect 跑在你的机器上，数据不出门。
+
+---
+
+## 快速开始
+
+### 一键安装
+
+openHermit 的 npm 包会捆绑安装并自动启动 cc-connect：
+
+```bash
+npm install -g @yancyyu/openhermit
+openhermit
+```
+
+浏览器打开 `http://127.0.0.1:5680`。
+
+首次启动会自动创建 `~/.hermit/cc-connect/config.toml`，启用 cc-connect Management API
+（9820）和 Bridge（9810），并生成本地 token。
+
+### 本地开发
+
+```bash
+git clone https://github.com/yancyuu/hermit.git
+cd hermit
+pnpm install
+pnpm dev
+```
+
+浏览器打开 `http://localhost:5174`
+
+开发模式默认连接本机 cc-connect；生产 CLI 会优先使用 openHermit 管理的
+`~/.hermit/cc-connect/config.toml`。
+
+### 创建第一个 AI 团队
+
+1. 点击「新建团队」
+2. 填写团队名、选 harness（如 `claudecode`）
+3. 选择对应的 cc-connect project
+4. 保存 → 看板就绪，任务等你分配
+
+---
+
+## 文件结构
+
+```
+~/.hermit/
+  └── teams/
+        ├── frontend/
+        │     ├── team.json        # 团队配置（harness、bindProject、color）
+        │     └── tasks/board.json # 任务看板
+        └── backend/
+              ├── team.json
+              └── tasks/board.json
+```
+
+所有数据存本地，可以用 Git 备份。
+
+---
+
+## 技术栈
+
+- **前端**：React + TypeScript + Tailwind CSS + Zustand
+- **后端**：Fastify（Node.js）
+- **存储**：本地文件（`~/.hermit/`）
+- **通信**：cc-connect Bridge WebSocket + Management HTTP API
+- **协议**：MCP over HTTP（SSE + JSON-RPC）
+
+---
+
+## 许可证
+
+[AGPL-3.0](LICENSE)

package/bin/hermit.mjs

@@ -0,0 +1,364 @@
+#!/usr/bin/env node
+/**
+ * openHermit CLI — production entry point.
+ *
+ * Usage:
+ *   npm install -g @yancyyu/openhermit
+ *   openhermit                # start on default port 5680
+ *   openhermit --port 8080    # start on custom port
+ *   openhermit --version      # show version
+ *   openhermit update         # check and install updates
+ *
+ * Or without global install:
+ *   npx @yancyyu/openhermit
+ *   npx @yancyyu/openhermit --port 8080
+ */
+
+import { spawn, execSync } from 'node:child_process';
+import crypto from 'node:crypto';
+import { mkdirSync, writeFileSync, readFileSync, existsSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const repoRoot = path.resolve(__dirname, '..');
+const require = createRequire(import.meta.url);
+
+// ---------------------------------------------------------------------------
+// Load version
+// ---------------------------------------------------------------------------
+
+const pkg = JSON.parse(readFileSync(path.join(repoRoot, 'package.json'), 'utf-8'));
+const currentVersion = pkg.version;
+
+// ---------------------------------------------------------------------------
+// Parse CLI args
+// ---------------------------------------------------------------------------
+
+const args = process.argv.slice(2);
+
+const versionIndex = args.indexOf('--version');
+if (versionIndex !== -1) {
+  console.log(currentVersion);
+  process.exit(0);
+}
+
+const helpIndex = args.indexOf('--help');
+if (helpIndex !== -1) {
+  console.log(`
+openHermit — Team-oriented agent management workbench
+
+Usage:
+  openhermit [options]
+
+Options:
+  --port <number>    HTTP server port (default: 5680)
+  --no-cc-connect    Do not auto-start bundled cc-connect
+  --version          Show current version
+  --help             Show this help message
+  update             Check and install updates
+
+Examples:
+  openhermit                      # Start on port 5680
+  openhermit --port 8080          # Start on port 8080
+  openhermit --no-cc-connect      # Start only openHermit
+  openhermit --version            # Show version
+  openhermit update               # Check for updates
+  npx @yancyyu/openhermit         # Run without installing
+`);
+  process.exit(0);
+}
+
+const updateIndex = args.indexOf('update');
+if (updateIndex !== -1) {
+  runUpdate();
+  process.exit(0);
+}
+
+const portIndex = args.indexOf('--port');
+const port = portIndex !== -1 && args[portIndex + 1] ? args[portIndex + 1] : '5680';
+const skipCcConnect = args.includes('--no-cc-connect') || process.env.HERMIT_NO_CC_CONNECT === '1';
+const hermitHome = process.env.HERMIT_HOME || path.join(os.homedir(), '.hermit');
+const ccConnectConfigPath =
+  process.env.HERMIT_CC_CONNECT_CONFIG ||
+  process.env.CC_CONNECT_CONFIG ||
+  path.join(hermitHome, 'cc-connect', 'config.toml');
+
+// ---------------------------------------------------------------------------
+// Update command
+// ---------------------------------------------------------------------------
+
+async function runUpdate() {
+  console.log('[openHermit] Checking for updates...');
+
+  const isGitRepo = existsSync(path.join(repoRoot, '.git'));
+
+  try {
+    // Check latest version from GitHub
+    const res = await fetch('https://api.github.com/repos/yancyuu/Hermit/releases/latest');
+    if (!res.ok) {
+      console.error('[openHermit] Failed to check for updates');
+      process.exit(1);
+    }
+
+    const data = await res.json();
+    const latestVersion = data.tag_name?.replace(/^v/, '');
+
+    if (!latestVersion) {
+      console.log('[openHermit] Already on latest version');
+      process.exit(0);
+    }
+
+    if (latestVersion === currentVersion) {
+      console.log(`[openHermit] Already on latest version (${currentVersion})`);
+      process.exit(0);
+    }
+
+    console.log(`[openHermit] Current version: ${currentVersion}`);
+    console.log(`[openHermit] Latest version: ${latestVersion}`);
+
+    if (isGitRepo) {
+      console.log('[openHermit] Updating from git repository...');
+      console.log('[openHermit] Fetching latest changes...');
+      execSync('git fetch --tags', { cwd: repoRoot, stdio: 'inherit' });
+
+      console.log(`[openHermit] Checking out v${latestVersion}...`);
+      execSync(`git checkout v${latestVersion}`, { cwd: repoRoot, stdio: 'inherit' });
+
+      console.log('[openHermit] Installing dependencies...');
+      execSync('npm install', { cwd: repoRoot, stdio: 'inherit' });
+
+      console.log('[openHermit] Building frontend...');
+      execSync('npm run build:web', { cwd: repoRoot, stdio: 'inherit' });
+
+      console.log(`\n[openHermit] Updated to openHermit ${latestVersion}`);
+      console.log('[openHermit] Please restart the server with: openhermit\n');
+    } else {
+      console.log('[openHermit] Updating via npm...');
+      execSync('npm update -g @yancyyu/openhermit', { stdio: 'inherit' });
+      console.log(`\n[openHermit] Updated to openHermit ${latestVersion}\n`);
+    }
+  } catch (err) {
+    console.error('[openHermit] Update failed:', err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Check dependencies
+// ---------------------------------------------------------------------------
+
+function checkDependency(name) {
+  try {
+    require.resolve(name);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+const missingDeps = [];
+if (!checkDependency('fastify')) missingDeps.push('fastify');
+if (!checkDependency('tsx')) missingDeps.push('tsx');
+
+if (missingDeps.length > 0) {
+  console.error(`
+[openHermit] Error: Missing dependencies: ${missingDeps.join(', ')}
+
+Please install dependencies first:
+  cd ${repoRoot}
+  npm install
+`);
+  process.exit(1);
+}
+
+// ---------------------------------------------------------------------------
+// cc-connect sidecar
+// ---------------------------------------------------------------------------
+
+function randomToken() {
+  return crypto.randomBytes(16).toString('hex');
+}
+
+function escapeTomlPath(value) {
+  return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+
+function parseTomlToken(raw, section) {
+  const match = raw.match(new RegExp(`\\[${section}\\][^\\[]*token\\s*=\\s*"([^"]+)"`, 's'));
+  return match?.[1] || '';
+}
+
+function ensureCcConnectConfig() {
+  mkdirSync(path.dirname(ccConnectConfigPath), { recursive: true });
+  if (!existsSync(ccConnectConfigPath)) {
+    const managementToken = randomToken();
+    const bridgeToken = randomToken();
+    const config = `data_dir = "${escapeTomlPath(path.join(hermitHome, 'cc-connect', 'data'))}"
+language = "zh"
+
+[management]
+enabled = true
+host = "127.0.0.1"
+port = 9820
+token = "${managementToken}"
+
+[bridge]
+enabled = true
+host = "127.0.0.1"
+port = 9810
+token = "${bridgeToken}"
+path = "/bridge/ws"
+
+[log]
+level = "info"
+`;
+    writeFileSync(ccConnectConfigPath, config, 'utf-8');
+  }
+
+  const raw = readFileSync(ccConnectConfigPath, 'utf-8');
+  return {
+    managementToken:
+      process.env.CC_CONNECT_TOKEN ||
+      process.env.CC_CONNECT_MANAGEMENT_TOKEN ||
+      parseTomlToken(raw, 'management'),
+    bridgeToken:
+      process.env.CC_CONNECT_BRIDGE_TOKEN ||
+      process.env.CC_CONNECT_TOKEN ||
+      parseTomlToken(raw, 'bridge'),
+  };
+}
+
+async function waitForCcConnect(baseUrl, token, timeoutMs = 15_000) {
+  const startedAt = Date.now();
+  while (Date.now() - startedAt < timeoutMs) {
+    try {
+      const res = await fetch(`${baseUrl}/api/v1/status`, {
+        headers: token ? { Authorization: `Bearer ${token}` } : undefined,
+      });
+      if (res.ok) return true;
+    } catch {
+      // keep polling
+    }
+    await new Promise((resolve) => setTimeout(resolve, 500));
+  }
+  return false;
+}
+
+function resolveCcConnectRunner() {
+  const pkgPath = require.resolve('cc-connect/package.json');
+  return path.join(path.dirname(pkgPath), 'run.js');
+}
+
+function resolveTsxCli() {
+  return require.resolve('tsx/cli');
+}
+
+let ccConnectProcess = null;
+let ccTokens = {
+  managementToken: process.env.CC_CONNECT_TOKEN || process.env.CC_CONNECT_MANAGEMENT_TOKEN || '',
+  bridgeToken: process.env.CC_CONNECT_BRIDGE_TOKEN || process.env.CC_CONNECT_TOKEN || '',
+};
+
+if (!skipCcConnect) {
+  ccTokens = ensureCcConnectConfig();
+  const ccBaseUrl = process.env.CC_CONNECT_BASE_URL || 'http://127.0.0.1:9820';
+  const alreadyRunning = await waitForCcConnect(ccBaseUrl, ccTokens.managementToken, 1_000);
+  if (alreadyRunning) {
+    console.log(`[openHermit] cc-connect already running: ${ccBaseUrl}`);
+  } else {
+    console.log('[openHermit] Starting bundled cc-connect...');
+    console.log(`[openHermit] cc-connect config: ${ccConnectConfigPath}`);
+    ccConnectProcess = spawn(process.execPath, [resolveCcConnectRunner(), '-config', ccConnectConfigPath], {
+      cwd: repoRoot,
+      env: {
+        ...process.env,
+        CC_CONNECT_TOKEN: ccTokens.managementToken,
+        CC_CONNECT_MANAGEMENT_TOKEN: ccTokens.managementToken,
+        CC_CONNECT_BRIDGE_TOKEN: ccTokens.bridgeToken,
+      },
+      stdio: 'inherit',
+    });
+    const ready = await waitForCcConnect(ccBaseUrl, ccTokens.managementToken, 15_000);
+    if (!ready) {
+      console.warn('[openHermit] cc-connect did not become ready within 15s; openHermit will keep trying via API.');
+    }
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Start server
+// ---------------------------------------------------------------------------
+
+console.log(`[openHermit] Starting openHermit server...`);
+console.log(`[openHermit] Version: ${currentVersion}`);
+console.log(`[openHermit] Port: ${port}`);
+console.log(`[openHermit] Root: ${repoRoot}`);
+console.log('');
+
+// Build dist-renderer if not exists
+const distRenderererDir = path.resolve(repoRoot, 'dist-renderer');
+
+if (!existsSync(distRenderererDir) || !existsSync(path.join(distRenderererDir, 'index.html'))) {
+  console.log('[openHermit] Building frontend...');
+  const buildProcess = spawn('npm', ['run', 'build:web'], {
+    cwd: repoRoot,
+    stdio: 'inherit',
+    shell: true,
+  });
+
+  await new Promise((resolve, reject) => {
+    buildProcess.on('exit', (code) => {
+      if (code === 0) {
+        resolve();
+      } else {
+        reject(new Error(`Frontend build failed with exit code ${code}`));
+      }
+    });
+    buildProcess.on('error', reject);
+  });
+  console.log('[openHermit] Frontend built successfully\n');
+}
+
+// Start the server
+console.log('[openHermit] Launching server...\n');
+
+const serverProcess = spawn(process.execPath, [resolveTsxCli(), 'src/main/server.ts'], {
+  cwd: repoRoot,
+  env: {
+    ...process.env,
+    PORT: port,
+    HOST: process.env.HOST || '127.0.0.1',
+    NODE_ENV: 'production',
+    HERMIT_HOME: hermitHome,
+    CC_CONNECT_TOKEN: ccTokens.managementToken,
+    CC_CONNECT_MANAGEMENT_TOKEN: ccTokens.managementToken,
+    CC_CONNECT_BRIDGE_TOKEN: ccTokens.bridgeToken,
+    CC_CONNECT_CONFIG: ccConnectConfigPath,
+  },
+  stdio: 'inherit',
+});
+
+serverProcess.on('exit', (code) => {
+  if (code !== 0) {
+    console.error(`[openHermit] Server exited with code ${code}`);
+    process.exit(code ?? 1);
+  }
+});
+
+process.on('SIGINT', () => {
+  console.log('\n[openHermit] Shutting down...');
+  serverProcess.kill('SIGINT');
+  ccConnectProcess?.kill('SIGINT');
+});
+
+process.on('SIGTERM', () => {
+  console.log('\n[openHermit] Shutting down...');
+  serverProcess.kill('SIGTERM');
+  ccConnectProcess?.kill('SIGTERM');
+});
+
+console.log(`[openHermit] Server starting on http://127.0.0.1:${port}`);
+console.log('[openHermit] Press Ctrl+C to stop\n');

package/bin/kill-dev.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { spawnSync } from 'child_process';
+
+const isWindows = process.platform === 'win32';
+
+if (isWindows) {
+  const r = spawnSync('taskkill', ['/F', '/IM', 'electron.exe'], {
+    stdio: 'inherit',
+    shell: true,
+  });
+  if (r.status != null && r.status !== 0 && r.status !== 128 && r.signal == null) {
+    process.exitCode = 1;
+  }
+} else {
+  const r = spawnSync('pkill', ['-f', 'electron-vite|electron \\.'], { stdio: 'inherit' });
+  if (r.status != null && r.status !== 0 && r.status !== 1 && r.signal == null) {
+    process.exitCode = 1;
+  }
+}
+console.log('Done');