Horcrux-AI

跨 Agent 同步你的 AI 人格 — 偏好、工具、习惯，一处管理。

安装（Claude Code）

把这个链接丢给 Claude Code，它会自动完成安装。

1. 获取 Token

前往 https://horcrux-ai.vercel.app ，用 Google 登录，在「开始使用」页面创建一个 API Token。

2. 配置 MCP Server

将以下配置写入 ~/.claude.json 的 mcpServers 字段（和 figma、notion 等 MCP 同级）：

{
  "horcrux": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "horcrux-ai@latest"],
    "env": {
      "HORCRUX_API_TOKEN": "<替换为你的 token>"
    }
  }
}

3. 安装 Skill

将仓库中的 skill/SKILL.md 复制到 ~/.claude/skills/sync-horcrux/SKILL.md。

安装后可用 /sync-horcrux 触发同步。

4. 重启并同步

重启 Claude Code，然后输入 /sync-horcrux 完成首次同步。

MCP 工具列表

| 工具 | 说明 | |------|------| | horcrux_sync | 一键同步：注册 Agent + 上传 MCP/Skill 列表 + 拉取偏好 | | get_profile | 获取偏好配置 | | update_preference | 更新偏好键值对 | | sync_tools | 上报当前 Agent 的 MCP/Skill 列表 | | get_tools | 查看所有已连接 Agent 的工具 | | log_usage | 记录使用日志 |

Dashboard

https://horcrux-ai.vercel.app

• 概览：偏好配置 + 已连接 Agent
• Token 管理：创建和撤销 API Token
• 使用统计：调用次数和事件日志

架构

Claude Code / Cursor / ...
   ↓ MCP (stdio)
horcrux-ai (npm)      ← 只持有用户 token，无密钥
   ↓ HTTPS
Vercel API (/api/mcp) ← 服务端持有 service key
   ↓
Supabase (Postgres + Auth)