cc2im 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 roxorlt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,120 @@
+# cc2im
+
+English | [中文](./README.md)
+
+WeChat IM gateway for multiple local Claude Code instances. Control your AI agents remotely via WeChat messages.
+
+## Architecture
+
+```
+WeChat (mobile)
+  ↓ iLink Bot API (long-poll)
+┌──────────────────────────────────┐
+│  cc2im hub (launchd daemon)      │
+│  · WeChat connection (multi-acct)│
+│  · @mention routing              │
+│  · Agent lifecycle management    │
+│  · Web Dashboard (:3721)         │
+│  · Cron task scheduler           │
+└──────────┬───────────────────────┘
+           │ Unix socket
+    ┌──────┴──────┐
+    ↓             ↓
+┌─────────┐  ┌─────────┐
+│ Spoke 1 │  │ Spoke N │
+│ (MCP)   │  │ (MCP)   │
+│ CC #1   │  │ CC #N   │
+│ ~/brain │  │ ~/proj  │
+└─────────┘  └─────────┘
+```
+
+## Install
+
+```bash
+npm install -g cc2im
+```
+
+**Requirements:** macOS, Node.js 22+, [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)
+
+## Quick Start
+
+```bash
+# 1. Scan QR code to log in to WeChat
+cc2im login
+
+# 2. Register your first agent
+cc2im agent register brain ~/brain
+
+# 3. Install as background service
+cc2im install
+
+# Done! Send a message via WeChat.
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `cc2im login` | WeChat QR code login |
+| `cc2im start` | Start hub + all autoStart agents |
+| `cc2im hub` | Start hub only (debug) |
+| `cc2im web` | Start Web Dashboard only |
+| `cc2im agent register <name> <dir>` | Register an agent |
+| `cc2im agent list` | List agent configs |
+| `cc2im agent start <name>` | Start agent in foreground (debug) |
+| `cc2im install` | Install launchd background service |
+| `cc2im uninstall` | Uninstall launchd service |
+| `cc2im status` | Check service status |
+| `cc2im logs` | Tail live logs |
+
+## WeChat Commands
+
+- `message` — Send to default agent
+- `@agent message` — Route to a specific agent
+- `@agent restart` — Restart agent (clears context)
+
+Management commands are handled by the default agent's Claude via natural language:
+
+- `start/stop <agent>` — Manage agent lifecycle
+- `status` — List all agents and their status
+- `register agent named X at /path` — Register a new agent
+
+## Web Dashboard
+
+Visit `http://127.0.0.1:3721` after starting to access:
+
+- Real-time message flow and agent status
+- Token usage and cost tracking
+- Multi-account WeChat management (QR login/disconnect)
+- Cron scheduled task management
+- Live log viewer
+
+## Multi-Account WeChat
+
+Supports multiple WeChat accounts simultaneously. Add new channels in the Dashboard's Channels page and scan QR codes to log in. Each channel can have a default agent, and messages are routed based on source channel.
+
+## Configuration
+
+All state is stored in `~/.cc2im/`:
+
+```
+~/.cc2im/
+├── hub.sock           Unix socket
+├── agents.json        Agent registry
+├── channels.json      Channel config
+├── cc2im.db           Message persistence + cron data (SQLite)
+├── hub.log            Hub log
+└── agents/
+    └── <name>/
+        └── spoke.log  Spoke log
+```
+
+WeChat credentials are stored in `~/.weixin-bot/` (separate file per channel).
+
+## Known Limitations
+
+cc2im is designed for **single-user scenarios** (one person controlling multiple agents via WeChat). Under multi-user concurrency, permission approvals and reply routing may race.
+
+## License
+
+[MIT](./LICENSE)

package/README.md

@@ -0,0 +1,120 @@
+# cc2im
+
+[English](./README.en.md) | 中文
+
+微信 IM 网关，连接多个本地 Claude Code 实例。通过微信消息远程控制你的 AI agent。
+
+## 架构
+
+```
+手机微信
+  ↓ iLink Bot API (long-poll)
+┌──────────────────────────────────┐
+│  cc2im hub (launchd daemon)      │
+│  · WeChat 连接（多账号支持）       │
+│  · @mention 路由                  │
+│  · Agent 生命周期管理              │
+│  · Web Dashboard (:3721)         │
+│  · Cron 定时任务调度               │
+└──────────┬───────────────────────┘
+           │ Unix socket
+    ┌──────┴──────┐
+    ↓             ↓
+┌─────────┐  ┌─────────┐
+│ Spoke 1 │  │ Spoke N │
+│ (MCP)   │  │ (MCP)   │
+│ CC #1   │  │ CC #N   │
+│ ~/brain │  │ ~/proj  │
+└─────────┘  └─────────┘
+```
+
+## 安装
+
+```bash
+npm install -g cc2im
+```
+
+**环境要求：** macOS, Node.js 22+, [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)
+
+## 快速开始
+
+```bash
+# 1. 微信扫码登录
+cc2im login
+
+# 2. 注册第一个 agent
+cc2im agent register brain ~/brain
+
+# 3. 安装为后台服务
+cc2im install
+
+# 完成！在微信里发消息即可。
+```
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `cc2im login` | 微信扫码登录 |
+| `cc2im start` | 启动 hub + 所有 autoStart agent |
+| `cc2im hub` | 仅启动 hub（调试用） |
+| `cc2im web` | 仅启动 Web Dashboard |
+| `cc2im agent register <name> <dir>` | 注册 agent |
+| `cc2im agent list` | 列出 agent 配置 |
+| `cc2im agent start <name>` | 前台启动 agent（调试用） |
+| `cc2im install` | 安装 launchd 后台服务 |
+| `cc2im uninstall` | 卸载 launchd 服务 |
+| `cc2im status` | 查看运行状态 |
+| `cc2im logs` | 查看实时日志 |
+
+## 微信指令
+
+- `消息` — 发送到默认 agent
+- `@agent 消息` — 路由到指定 agent
+- `@agent 重启` — 重启 agent（清空上下文）
+
+管理指令由默认 agent 的 Claude 通过自然语言处理：
+
+- `启动/停止 <agent>` — 管理 agent 生命周期
+- `状态` — 列出所有 agent 及状态
+- `注册 agent 叫 X，目录是 /path` — 注册新 agent
+
+## Web Dashboard
+
+启动后访问 `http://127.0.0.1:3721`，可查看：
+
+- 实时消息流和 agent 状态
+- Token 用量和费用统计
+- 多微信账号管理（扫码登录/断开）
+- Cron 定时任务管理
+- 实时日志
+
+## 多微信账号
+
+支持同时登录多个微信账号。在 Dashboard 的 Channels 页面添加新 channel，扫码登录即可。每个 channel 可以绑定默认 agent，消息会根据来源 channel 路由。
+
+## 配置
+
+所有状态存储在 `~/.cc2im/`：
+
+```
+~/.cc2im/
+├── hub.sock           Unix socket
+├── agents.json        Agent 注册表
+├── channels.json      Channel 配置
+├── cc2im.db           消息持久化 + Cron 数据（SQLite）
+├── hub.log            Hub 日志
+└── agents/
+    └── <name>/
+        └── spoke.log  Spoke 日志
+```
+
+微信凭证存储在 `~/.weixin-bot/`（每个 channel 独立文件）。
+
+## 已知限制
+
+cc2im 为**单用户场景**设计（一个人通过微信控制自己的多个 agent）。多用户并发时，权限审批和回复路由可能出现竞争。
+
+## License
+
+[MIT](./LICENSE)

package/dist/cli.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * cc2im CLI
+ *
+ * cc2im login              — 微信扫码登录
+ * cc2im hub                — 启动 hub（前台，调试用）
+ * cc2im start              — 启动 hub + 所有 autoStart agent
+ * cc2im agent start <name> — 手动启动一个 agent（前台，调试用）
+ * cc2im agent stop <name>  — 停止一个 agent
+ * cc2im agent list         — 列出所有 agent
+ * cc2im install            — 安装 launchd 服务（后台运行）
+ * cc2im uninstall          — 卸载 launchd 服务
+ * cc2im status             — 查看运行状态
+ * cc2im logs               — 查看日志
+ */
+export {};

package/dist/cli.js

@@ -0,0 +1,314 @@
+#!/usr/bin/env node
+/**
+ * cc2im CLI
+ *
+ * cc2im login              — 微信扫码登录
+ * cc2im hub                — 启动 hub（前台，调试用）
+ * cc2im start              — 启动 hub + 所有 autoStart agent
+ * cc2im agent start <name> — 手动启动一个 agent（前台，调试用）
+ * cc2im agent stop <name>  — 停止一个 agent
+ * cc2im agent list         — 列出所有 agent
+ * cc2im install            — 安装 launchd 服务（后台运行）
+ * cc2im uninstall          — 卸载 launchd 服务
+ * cc2im status             — 查看运行状态
+ * cc2im logs               — 查看日志
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { spawn } from 'node:child_process';
+import qrterm from 'qrcode-terminal';
+import { SOCKET_DIR, ensureSocketDir } from './shared/socket.js';
+import { ensureMcpJson } from './shared/mcp-config.js';
+const AGENTS_JSON_PATH = join(SOCKET_DIR, 'agents.json');
+const BASE_URL = 'https://ilinkai.weixin.qq.com';
+const BANNER = [
+    '',
+    '\x1b[36m\x1b[1m   ██████╗ ██████╗██████╗ ██╗███╗   ███╗\x1b[0m',
+    '\x1b[36m\x1b[1m  ██╔════╝██╔════╝╚════██╗██║████╗ ████║\x1b[0m',
+    '\x1b[36m\x1b[1m  ██║     ██║      █████╔╝██║██╔████╔██║\x1b[0m',
+    '\x1b[36m\x1b[1m  ██║     ██║     ██╔═══╝ ██║██║╚██╔╝██║\x1b[0m',
+    '\x1b[36m\x1b[1m  ╚██████╗╚██████╗███████╗██║██║ ╚═╝ ██║\x1b[0m',
+    '\x1b[36m\x1b[1m   ╚═════╝ ╚═════╝╚══════╝╚═╝╚═╝     ╚═╝\x1b[0m',
+    '\x1b[2m    Claude Code ↔ WeChat IM Gateway\x1b[0m',
+    '\x1b[2m              by \x1b[0m\x1b[33mroxorlt\x1b[0m',
+    '',
+].join('\n');
+const CRED_DIR = join(homedir(), '.weixin-bot');
+const CRED_PATH = join(CRED_DIR, 'credentials.json');
+const POLL_INTERVAL = 2000;
+// --- Helpers ---
+function loadAgentsJson() {
+    if (existsSync(AGENTS_JSON_PATH)) {
+        return JSON.parse(readFileSync(AGENTS_JSON_PATH, 'utf8'));
+    }
+    return null;
+}
+function ensureDefaultConfig() {
+    ensureSocketDir();
+    if (!existsSync(AGENTS_JSON_PATH)) {
+        const defaultConfig = {
+            defaultAgent: 'brain',
+            agents: {
+                brain: {
+                    name: 'brain',
+                    cwd: join(homedir(), 'brain'),
+                    claudeArgs: ['--effort', 'max'],
+                    createdAt: new Date().toISOString().split('T')[0],
+                    autoStart: true,
+                },
+            },
+        };
+        writeFileSync(AGENTS_JSON_PATH, JSON.stringify(defaultConfig, null, 2) + '\n');
+        console.log(`[cc2im] Created default config: ${AGENTS_JSON_PATH}`);
+    }
+}
+// --- Commands ---
+async function login() {
+    console.log(BANNER);
+    console.log('正在获取登录二维码...\n');
+    let qrData;
+    try {
+        const qrResp = await fetch(`${BASE_URL}/ilink/bot/get_bot_qrcode?bot_type=3`);
+        qrData = await qrResp.json();
+    }
+    catch (err) {
+        console.error(`无法连接 iLink 服务器: ${err.message}`);
+        process.exit(1);
+    }
+    const qrUrl = qrData.qrcode_img_content;
+    const qrToken = qrData.qrcode;
+    console.log('请用微信扫一扫下方二维码:\n');
+    qrterm.generate(qrUrl, { small: true });
+    console.log(`\n(也可手动复制链接在微信内打开: ${qrUrl})\n`);
+    let lastStatus = '';
+    while (true) {
+        const statusResp = await fetch(`${BASE_URL}/ilink/bot/get_qrcode_status?qrcode=${encodeURIComponent(qrToken)}`, { headers: { 'iLink-App-ClientVersion': '1' } });
+        const status = await statusResp.json();
+        if (status.status !== lastStatus) {
+            if (status.status === 'scaned')
+                console.log('已扫码，请在微信中确认授权...');
+            if (status.status === 'expired') {
+                console.log('二维码已过期，请重新运行: cc2im login');
+                process.exit(1);
+            }
+            lastStatus = status.status;
+        }
+        if (status.status === 'confirmed') {
+            if (!status.bot_token || !status.ilink_bot_id || !status.ilink_user_id) {
+                console.error('授权成功但未返回凭证，请重试');
+                process.exit(1);
+            }
+            const credentials = {
+                token: status.bot_token,
+                baseUrl: status.baseurl || BASE_URL,
+                accountId: status.ilink_bot_id,
+                userId: status.ilink_user_id,
+            };
+            mkdirSync(CRED_DIR, { recursive: true, mode: 0o700 });
+            writeFileSync(CRED_PATH, JSON.stringify(credentials, null, 2) + '\n', { mode: 0o600 });
+            console.log(`\n登录成功!`);
+            console.log(`  accountId: ${credentials.accountId}`);
+            console.log(`  userId:    ${credentials.userId}`);
+            console.log(`  凭证已保存到 ${CRED_PATH}`);
+            break;
+        }
+        await new Promise(r => setTimeout(r, POLL_INTERVAL));
+    }
+}
+async function runHub() {
+    ensureDefaultConfig();
+    const { startHub } = await import('./hub/index.js');
+    await startHub({ autoStartAgents: false });
+}
+async function runStart() {
+    ensureDefaultConfig();
+    console.log('[cc2im] Starting hub + auto-start agents...');
+    const { startHub } = await import('./hub/index.js');
+    await startHub({ autoStartAgents: true });
+}
+function startAgentForeground(name) {
+    const config = loadAgentsJson();
+    if (!config?.agents?.[name]) {
+        console.error(`Agent "${name}" not found in ${AGENTS_JSON_PATH}`);
+        process.exit(1);
+    }
+    const agent = config.agents[name];
+    // Resolve spoke script path (works for both tsx/src and compiled/dist)
+    const dir = import.meta.dirname;
+    const spokeTs = join(dir, 'spoke', 'index.ts');
+    const spokeJs = join(dir, 'spoke', 'index.js');
+    const spokeScript = existsSync(spokeTs) ? spokeTs : spokeJs;
+    ensureMcpJson(agent.cwd, spokeScript, name);
+    const claudeArgs = [
+        '--dangerously-load-development-channels', 'server:cc2im',
+        ...(agent.claudeArgs || []),
+    ];
+    const cmd = process.platform === 'darwin' ? 'caffeinate' : 'claude';
+    const args = process.platform === 'darwin' ? ['-i', 'claude', ...claudeArgs] : claudeArgs;
+    console.log(`[cc2im] Starting agent "${name}" in ${agent.cwd} (foreground)`);
+    const child = spawn(cmd, args, {
+        cwd: agent.cwd,
+        stdio: 'inherit',
+    });
+    child.on('exit', (code) => {
+        console.log(`[cc2im] Agent "${name}" exited with code ${code}`);
+        process.exit(code ?? 0);
+    });
+}
+function agentRegister(name, cwd) {
+    ensureDefaultConfig();
+    const config = JSON.parse(readFileSync(AGENTS_JSON_PATH, 'utf8'));
+    if (config.agents[name]) {
+        console.error(`Agent "${name}" already exists`);
+        process.exit(1);
+    }
+    if (!existsSync(cwd)) {
+        console.error(`Directory "${cwd}" does not exist`);
+        process.exit(1);
+    }
+    config.agents[name] = {
+        name,
+        cwd,
+        claudeArgs: [],
+        createdAt: new Date().toISOString().split('T')[0],
+        autoStart: false,
+    };
+    writeFileSync(AGENTS_JSON_PATH, JSON.stringify(config, null, 2) + '\n');
+    console.log(`[cc2im] Registered agent "${name}" → ${cwd}`);
+}
+function agentDeregister(name) {
+    ensureDefaultConfig();
+    const config = JSON.parse(readFileSync(AGENTS_JSON_PATH, 'utf8'));
+    if (!config.agents[name]) {
+        console.error(`Agent "${name}" not found`);
+        process.exit(1);
+    }
+    delete config.agents[name];
+    if (config.defaultAgent === name) {
+        config.defaultAgent = Object.keys(config.agents)[0] || '';
+    }
+    writeFileSync(AGENTS_JSON_PATH, JSON.stringify(config, null, 2) + '\n');
+    console.log(`[cc2im] Deregistered agent "${name}"`);
+}
+function agentList() {
+    const config = loadAgentsJson();
+    if (!config) {
+        console.log('No agents configured. Run `cc2im hub` to create default config.');
+        return;
+    }
+    console.log(`Default agent: ${config.defaultAgent}\n`);
+    for (const [name, agent] of Object.entries(config.agents)) {
+        const isDefault = name === config.defaultAgent ? ' ★' : '';
+        console.log(`  ${name}${isDefault}`);
+        console.log(`    cwd: ${agent.cwd}`);
+        console.log(`    autoStart: ${agent.autoStart ?? false}`);
+        console.log(`    claudeArgs: ${(agent.claudeArgs || []).join(' ')}`);
+        console.log();
+    }
+}
+// --- Main ---
+const command = process.argv[2];
+const subcommand = process.argv[3];
+const arg = process.argv[4];
+switch (command) {
+    case '--version':
+    case '-v':
+        console.log('cc2im v0.1.0');
+        break;
+    case 'login':
+        await login();
+        break;
+    case 'hub':
+        await runHub();
+        break;
+    case 'start':
+        await runStart();
+        break;
+    case 'agent':
+        switch (subcommand) {
+            case 'register': {
+                const regCwd = process.argv[5];
+                if (!arg || !regCwd) {
+                    console.error('Usage: cc2im agent register <name> <cwd>');
+                    process.exit(1);
+                }
+                agentRegister(arg, regCwd);
+                break;
+            }
+            case 'deregister':
+                if (!arg) {
+                    console.error('Usage: cc2im agent deregister <name>');
+                    process.exit(1);
+                }
+                agentDeregister(arg);
+                break;
+            case 'start':
+                if (!arg) {
+                    console.error('Usage: cc2im agent start <name>');
+                    process.exit(1);
+                }
+                startAgentForeground(arg);
+                break;
+            case 'stop':
+                console.log('Use `cc2im start` to run hub-managed agents, then stop via WeChat or MCP tools.');
+                break;
+            case 'list':
+                agentList();
+                break;
+            default:
+                console.error(`Unknown agent command: ${subcommand}`);
+                console.error('Usage: cc2im agent [register|deregister|start|stop|list] [name] [cwd]');
+                process.exit(1);
+        }
+        break;
+    case 'install': {
+        const { install } = await import('./hub/launchd.js');
+        install();
+        break;
+    }
+    case 'uninstall': {
+        const { uninstall } = await import('./hub/launchd.js');
+        uninstall();
+        break;
+    }
+    case 'status': {
+        const { status } = await import('./hub/launchd.js');
+        status();
+        break;
+    }
+    case 'logs': {
+        const { logs } = await import('./hub/launchd.js');
+        logs();
+        break;
+    }
+    case 'web': {
+        const webPort = parseInt(process.argv.find((a, i) => process.argv[i - 1] === '--port') || '3721');
+        const { startWeb } = await import('./plugins/web-monitor/server.js');
+        const handle = await startWeb({ port: webPort });
+        const shutdown = () => { handle.shutdown(); process.exit(0); };
+        process.on('SIGTERM', shutdown);
+        process.on('SIGINT', shutdown);
+        break;
+    }
+    case '--help':
+    case '-h':
+    default:
+        console.log(`cc2im v0.1.0 — IM gateway for multiple Claude Code instances
+
+Usage:
+  cc2im login              微信扫码登录
+  cc2im hub                启动 hub（前台调试，不启动 agent）
+  cc2im start              启动 hub + 所有 autoStart agent
+  cc2im agent start <name> 前台启动指定 agent（调试用）
+  cc2im agent list         列出所有 agent 配置
+
+  cc2im install            安装 launchd 后台服务
+  cc2im uninstall          卸载 launchd 服务
+  cc2im status             查看运行状态
+  cc2im logs               查看实时日志
+
+  cc2im web                监控面板（默认端口 3721）
+  cc2im web --port 8080    指定端口
+`);
+}

package/dist/hub/agent-manager.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Agent Lifecycle Manager — hub 侧
+ * 管理 agent 的注册/注销、启动/停止、健康检查
+ */
+import type { AgentsConfig } from '../shared/types.js';
+export declare class AgentManager {
+    private processes;
+    private config;
+    private getConnectedAgents;
+    private onEvent?;
+    private stoppedManually;
+    private shuttingDown;
+    private restartAttempts;
+    constructor(getConnectedAgents: () => string[], onEvent?: (kind: string, agentId: string, extra?: Record<string, any>) => void);
+    private loadConfig;
+    private saveConfig;
+    getConfig(): AgentsConfig;
+    reloadConfig(): void;
+    register(name: string, cwd: string, claudeArgs?: string[]): {
+        success: boolean;
+        error?: string;
+    };
+    deregister(name: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    start(name: string): {
+        success: boolean;
+        error?: string;
+    };
+    /** Stop an agent and wait for the process to exit (with timeout).
+     *  Marks as manually stopped — will NOT auto-restart. */
+    stop(name: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    list(): Array<{
+        name: string;
+        cwd: string;
+        status: 'connected' | 'starting' | 'stopped';
+        autoStart: boolean;
+        claudeArgs: string[];
+        isDefault: boolean;
+    }>;
+    /** Kill an agent's entire process tree (caffeinate → expect → claude).
+     *  Uses negative PID to kill the process group created by detached: true. */
+    private killProcessTree;
+    /** Kill an agent's process for restart (e.g., after heartbeat eviction).
+     *  Does NOT mark as manually stopped — child.on('exit') will auto-restart. */
+    killForRestart(name: string): void;
+    restart(name: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    updateEffort(name: string, effort: string): {
+        success: boolean;
+        error?: string;
+    };
+    startAutoAgents(): void;
+    /** Check if this agent's process is managed (spawned) by the hub. */
+    isManaged(name: string): boolean;
+    stopAll(): Promise<void>;
+}