@nodeskai/genehub - GeneHub CLI

AI 员工基因管理命令行工具，用于搜索、安装、发布基因到 GeneHub Registry。

安装

npm install -g @nodeskai/genehub

配置

配置文件

genehub config set registry https://genehub.nodeskai.com
genehub config set token <your-token>
genehub config get

配置文件存储在 ~/.genehub/config.json。

环境变量

环境变量优先级高于配置文件：

| 环境变量 | 说明 | 对应配置项 | |---|---|---| | GENEHUB_REGISTRY_URL | Registry 地址 | registry | | GENEHUB_REGISTRY | Registry 地址（别名） | registry | | GENEHUB_TOKEN | 认证 Token | token |

本地开发示例：

GENEHUB_REGISTRY_URL=http://localhost:3000 GENEHUB_TOKEN=dev genehub publish ./my-gene

认证

使用 GitHub OAuth 登录，自动创建 API Key：

genehub auth login      # 打开浏览器完成 GitHub 登录，自动保存 token
genehub auth status     # 查看当前登录状态
genehub auth logout     # 退出登录（清除本地 token）

命令

| 命令 | 说明 | |---|---| | genehub auth login | GitHub OAuth 登录 | | genehub auth status | 查看登录状态 | | genehub auth logout | 退出登录 | | genehub search [keyword] | 搜索基因库 | | genehub install <slug> | 安装基因到当前 Agent 环境 | | genehub uninstall <slug> | 卸载基因 | | genehub publish <path> | 发布基因到 Registry（自动检测 CLAUDE.md / SKILL.md / AGENTS.md） | | genehub publish <path> -y | 非交互模式发布（使用默认值） | | genehub list | 列出已安装的基因 | | genehub learn <slug> | 触发基因深度学习（L2） | | genehub init | 初始化基因项目 | | genehub config | 管理配置 |

自动检测发布

genehub publish 支持直接发布包含 skill 文件的目录，无需预先创建 gene.yaml：

# 目录中有 CLAUDE.md / SKILL.md / AGENTS.md 等文件即可
genehub publish ./my-claude-project

检测优先级：CLAUDE.md > SKILL.md > AGENTS.md > .cursorrules > .clinerules > instructions.md > *.md

自动推断的字段：

• slug：从目录名生成（kebab-case）
• name：从文件 H1 标题或 frontmatter 提取
• description：从文件首段内容提取
• skill.content：完整文件内容

需要交互确认的字段（-y 可跳过）：

• category（默认 development）
• tags（默认 ability）

首次发布后会自动生成 gene.yaml 保存到目录中，后续发布可直接使用。

目录结构

packages/cli/
├── src/
│   ├── index.ts          # 入口，注册所有命令
│   ├── config.ts         # 配置管理（文件 + 环境变量）
│   ├── output.ts         # 格式化输出工具
│   ├── utils/
│   │   ├── detect-skill.ts         # Skill 文件自动检测
│   │   └── interactive-manifest.ts # 交互式 manifest 构建
│   └── commands/
│       ├── auth.ts       # GitHub OAuth 登录
│       ├── config.ts     # config set / get
│       ├── init.ts       # 初始化基因项目
│       ├── install.ts    # 安装基因
│       ├── learn.ts      # 深度学习
│       ├── list.ts       # 列出已安装基因
│       ├── publish.ts    # 发布基因（支持自动检测）
│       ├── search.ts     # 搜索基因
│       └── uninstall.ts  # 卸载基因
├── dist/                 # 构建产物
├── package.json
└── tsup.config.ts

开发

cd packages/cli
pnpm install
pnpm build          # 构建
pnpm dev            # 开发模式
pnpm test           # 测试