funcoding-cli
给 AI 编程智能体用的命令行：查找和安装 Agent Skills、配置 MCP Server、同步收藏，查看 AI 热点和中文文档。
让智能体用起来
把下面这句话发给 Claude Code、Codex 或 Cursor。init 会全局安装本工具，并给智能体装上 funcoding Skill，之后它会在需要时自行调用本工具。
运行 npx --yes funcoding-cli@latest init，然后帮我找一个处理 PDF 的 Skill 并安装。
也可以自己在终端中运行（需要 Node.js 18.17 及以上版本）：
全局安装，并给当前智能体装上 funcoding Skill
npx --yes funcoding-cli@latest init
安装后命令是 funcoding，可简写为 fun：把 Skill 装到本机所有智能体
fun skills add anthropics/skills/pdf --agent=all
给 Cursor 配置 MCP Server
fun mcp add <owner/repo> --agent=cursor
命令
常用
- funcoding init
- 全局安装本工具，并给智能体装上 funcoding Skill。
- funcoding update
- 更新到最新版本，并刷新已安装的 funcoding Skill。
- funcoding info [<field>]
- 查看环境信息：版本、登录状态、本机的智能体和 Skill 目录。
- funcoding help [<command>]
- 查看帮助；每条命令也都可以加 --help。
Skill
- funcoding skills find <query>
- 按关键词查找 Skill。
- funcoding skills info <id>
- 查看描述、文件清单和 SKILL.md 全文，供智能体在安装前检查。
- funcoding skills add <id>...
- 安装一个或多个 Skill，也可以直接粘贴网站上的详情页地址。
- funcoding skills list
- 列出各智能体在用户目录和当前项目中已安装的 Skill。
- funcoding skills update [<name>]
- 按原来源重新安装；加 --check 只检查是否有更新。
- funcoding skills remove <name>...
- 删除通过 funcoding-cli 安装的 Skill，删除前自动备份。
MCP
- funcoding mcp find <query>
- 按关键词查找 MCP Server。
- funcoding mcp info <id>
- 查看可用的启动方式，以及需要提供的环境变量或请求头。
- funcoding mcp add <id>
- 写入智能体的 MCP 配置，必填项用 --env 或 --header 提供。
- funcoding mcp list
- 列出已配置的 MCP Server。
- funcoding mcp remove <name>...
- 删除 MCP Server 配置，修改前自动备份原文件。
收藏
- funcoding auth login | logout | status
- 在浏览器中授权登录、退出登录、查看当前账号。
- funcoding favorites list
- 列出你在网站上收藏的 Skill 和 MCP Server。
- funcoding favorites sync
- 一次安装全部收藏，已安装的自动跳过。
热点与文档
- funcoding news list
- 查看当前 AI 热榜。
- funcoding news daily [<date>]
- 查看某一天的 AI 日报，不写日期时为最新一期。
- funcoding docs search <query>
- 搜索站内中文文档，可用 --agent 按智能体筛选。
- funcoding docs fetch <agent/path>
- 读取文档全文（Markdown），附官方来源和核实日期。
给智能体的约定
所有命令都是非交互的，需要确认的地方一律通过参数表达。
- 加上 --json 后，stdout 只输出一个 JSON 对象：成功时为 { "ok": true, … }，失败时为 { "ok": false, "error": { "code", "message", "hint" } }，hint 给出下一步可以运行的命令。
- --agent 指定目标智能体（claude-code、codex、cursor，多个用逗号分隔，all 表示本机检测到的全部）；不指定时，在 Claude Code 中运行默认装给 Claude Code。
- --project 装到当前项目，可随仓库提交；不加时装到用户目录，对所有项目生效。
| 退出码 | 含义 |
|---|---|
| 0 | 成功 |
| 1 | 一般错误 |
| 2 | 参数错误或缺少必填项 |
| 3 | 未找到 |
| 4 | 目标已存在，需要 --force |
| 5 | 未登录或登录已过期 |
安装位置
位置取自各智能体的官方文档，具体以官方文档为准。
| --agent | Skill | MCP |
|---|---|---|
| claude-code | ~/.claude/skills/ .claude/skills/ | claude mcp add-json --scope user .mcp.json |
| codex | ~/.agents/skills/ .agents/skills/ | ~/.codex/config.toml .codex/config.toml |
| cursor | ~/.cursor/skills/ .cursor/skills/ | ~/.cursor/mcp.json .cursor/mcp.json |
第一行为用户目录，第二行为当前项目（--project）。
安全说明
- Skill 会按 SKILL.md 的指示执行操作，并可能运行其中的脚本。funcoding Skill 要求智能体在安装前先用 skills info 检查内容，并征得你的同意。
- funcoding-cli 只从 GitHub 下载 Skill 所在目录的文件，并拒绝任何超出目标目录的路径；单个 Skill 最多 200 个文件、10 MB。
- 覆盖、删除 Skill 和修改 MCP 配置前，都会把原内容备份到 CLI 的配置目录（macOS 和 Linux 为 ~/.config/funcoding/，Windows 为 %APPDATA%\funcoding）。
- MCP 需要的密钥只通过命令参数写入对应智能体的配置文件，不会上传到网站。