@icen.ai/cli

icen — icen.ai skill 生态的统一命令行工具，从 skill.icen.ai 安装和管理 AI agent skills。

The unified CLI for the icen.ai skill ecosystem — install and manage AI agent skills from skill.icen.ai.

安装 / Install

npx @icen.ai/cli --help     # Node ≥ 18
bunx @icen.ai/cli --help    # Bun

或直接运行命令，如 npx @icen.ai/cli add network。

命令 / Commands

命令	说明
icen add <id>	安装或更新 skill（幂等，hash 相同自动跳过）。id 支持短 id（network）或全名（icen-network）
icen remove <id>	卸载 skill（含各平台目录同步删除）
icen list	列出已安装 skill（读 lock 文件）
icen update [id]	更新指定或全部已安装 skill
icen search <query>	在 registry 的双语名称 / tags / keywords 中搜索
icen key <KEY>	设置 API 密钥（格式 ICEN-XXXX-XXXX，写入 ~/.icen/credentials.json）
icen whoami	显示当前凭证状态与账号信息

常用 flags：-y/--yes（跳过确认）、--no-sync（只装主目录）、--json（JSON 输出）、--registry <url>（临时换源）、--key <KEY>（临时指定密钥）。

鉴权 / Auth

免费 skill 无需凭证。付费 skill（index.json 中 paid: true）需要安装密钥，凭证优先级：

--key 参数  >  环境变量 ICEN_KEY  >  ~/.icen/credentials.json

icen key ICEN-A1B2-C3D4    # 在 https://skill.icen.ai/account 获取密钥
icen add <paid-skill>

付费包从 <registry>/k/<key>/<name>.tar.gz 下载，与官方 install.sh 走同一条鉴权路径。

环境变量 / Environment Variables

变量	说明	默认值
ICEN_BASE_URL	registry 地址	https://skill.icen.ai
ICEN_KEY	安装密钥	—
ICEN_HOME	凭证目录	~/.icen
ICEN_SKILLS_DIR	主 skills 目录	~/.agents/skills
NO_COLOR	禁用颜色输出	—

安装行为 / Install Behavior

与官方 install.sh 完全互操作：同一个 lock 文件（~/.agents/skills/.icen-lock.json）、同一套目录布局——主目录 ~/.agents/skills 必装，~/.claude、~/.cursor、~/.kimi-code 等平台根目录存在时同步铺到其 skills/ 子目录。混用 install.sh 和 CLI 不会互相踩。

Fully interoperable with the official install.sh: same lock file and same directory layout.

License

MIT