Changelog#
6.5.1 (2026-07-13)#
Features#
- Add a branded banner to the root help output (#184)
- Add
antd lint --diff [base]and--staged, report skipped files, and cover Ant Design v5 usage patterns (#188, #189, #192) - Extend
antd setupwith GitHub Actions CI configuration (#190)
Bug Fixes#
- Ignore non-JavaScript asset imports in the lint performance rule (#186)
- Preserve historical metadata, dotted semantic keys, prerelease ordering, and a bounded metadata cache (#194, #195, #198, #199)
- Improve changelog extraction by preserving emoji and ownership, avoiding guessed prop renames, and validating inferred component names (#196, #197, #201)
Security#
- Prevent shell injection in release tag handling while keeping sync commands portable on Windows (#193)
Other Changes#
- Allow package-size reporting to continue when GitHub comment permissions are unavailable (#187)
- Bump dependencies (#183, #191)
- Update antd metadata (v6@6.5.1)
新功能#
- 为根帮助信息新增品牌化 Banner (#184)
- 新增
antd lint --diff [base]和--staged,报告跳过的文件,并覆盖 Ant Design v5 使用规则 (#188, #189, #192) - 扩展
antd setup,支持配置 GitHub Actions CI (#190)
Bug 修复#
- lint 性能规则不再误报非 JavaScript 资源导入 (#186)
- 保留历史元数据、点号语义键和预发布版本顺序,并限制元数据缓存大小 (#194, #195, #198, #199)
- 改进 changelog 提取,保留 emoji 与归属关系,不再猜测属性重命名,并校验推断出的组件名 (#196, #197, #201)
安全#
- 防止发布 tag 处理中的 shell 注入,同时保持同步命令在 Windows 上可用 (#193)
其他变更#
6.5.0 (2026-06-27)#
Documentation#
- Expand the v6.4.5 release notes (#181)
Other Changes#
- Update antd metadata (v6@6.5.0)
文档#
- 补充 v6.4.5 发布说明 (#181)
其他变更#
- 同步 antd 元数据 (v6@6.5.0)
6.4.5 (2026-06-22)#
Features#
- New
antd setupcommand for initializing Ant Design projects and configuration (#165) antd migratecan now scan a directory and generate targeted migration prompts from actual usage (#159)
Bug Fixes#
- Fix sync release authentication and recovery paths so missing or failed publish artifacts are detected and repaired reliably (#180, #179, #178, #177, #176)
- Harden the sync workflow against missing release tags, corrupted version indexes, stale token metadata, and data-only sync changes (#174, #173, #172, #171, #170, #169, #168)
- Keep doctor bug checks offline so tests and normal runs do not make network calls (#164)
- Count
antdsubpath default imports in usage analysis (#163) - Avoid stack traces for invalid global options (#162)
Security#
- Resolve Dependabot security alerts (#167)
Other Changes#
- Bump dependencies (#175, #160, #157)
- Keep update-check cache tests safely mocked (#161)
- Add Chinese release notes for v6.4.4 (#158)
- Update antd metadata (v6@6.4.5)
新功能#
- 新增
antd setup命令,用于初始化 Ant Design 项目和相关配置 (#165) antd migrate现在可以扫描目录,并基于实际使用情况生成更有针对性的迁移提示词 (#159)
Bug 修复#
- 修复同步发布流程的鉴权与恢复路径,确保缺失或失败的发布产物能被可靠检测和修复 (#180, #179, #178, #177, #176)
- 增强同步流程,覆盖 release tag 缺失、版本索引损坏、Token 元数据过期和纯数据同步变更等场景 (#174, #173, #172, #171, #170, #169, #168)
- 保持 doctor bug 检查离线执行,避免测试和普通运行触发网络请求 (#164)
usage分析现在会统计antd子路径的默认导入 (#163)- 传入无效全局选项时不再输出堆栈信息 (#162)
安全#
- 修复 Dependabot 安全告警 (#167)
其他变更#
- 升级依赖 (#175, #160, #157)
- 保持升级检查缓存相关测试使用安全 mock (#161)
- 为 v6.4.4 补充中文发布说明 (#158)
- 同步 antd 元数据 (v6@6.4.5)
6.4.4 (2026-06-12)#
Features#
- New
antd design.mdcommand — outputs antd's design language specification (colors, typography, spacing, radius, and design principles) in design.md format, ready for AI design tools like Figma Make and Stitch. Also available asantd_design_mdMCP tool (#147, ant-design#57701) - New
antd upgradecommand — update the CLI to the latest version without leaving your terminal (#123) - All commands now support
--format markdownoutput and--lang zhfor Chinese labels (#146) antd infonow shows a note about common props (className/style/rootClassName) shared by all components (#139)
Bug Fixes#
- Fix version auto-detection defaulting to v5 instead of v6 when antd is not installed locally (#150)
antd mcpnow shows a helpful message when run directly in a terminal instead of silently hanging (#154)- Fix some components (e.g. those with only sub-component props) failing to display in
antd info(#152) - Fix missing or malformed prop metadata and token data for some components across v5/v6 (#138, #132, #122, #125)
- Fix markdown table output with special characters being incorrectly escaped (#136)
- Fix invalid
--formator--langvalues being silently ignored instead of showing an error (#141) - Fix version parsing,
antd upgradecomparison, andantd semantic --lang zhcrash (#127)
Security#
- Fix potential shell injection in build scripts (#137, #134)
- Upgrade
qsto 6.15.2 to resolve CVE-2026-8723 (#121)
Other Changes#
- Reduce npm package size by excluding skills
node_modules(#144) - Add Codex and OpenAI Agents support (#151)
- Improve sync workflow reliability (#155, #156, #135, #133)
- Bump dependencies (#149, #148, #130, #119, #117)
- Update antd metadata to v6.4.4 (diff)
新功能#
- 新增
antd design.md命令,输出 antd 设计语言规范(颜色、字体、间距、圆角及设计原则),兼容 design.md 格式,可被 Figma Make、Stitch 等 AI 设计工具直接使用,同时提供antd_design_mdMCP tool (#147, ant-design#57701) - 新增
antd upgrade命令,在终端内一键升级 CLI 到最新版本 (#123) - 所有命令新增
--format markdown输出格式和--lang zh中文显示支持 (#146) antd info输出中新增所有组件通用属性(className/style/rootClassName)的说明 (#139)
Bug 修复#
- 修复未安装 antd 时版本自动检测错误回退到 v5 而非最新 v6 的问题 (#150)
antd mcp在终端中直接运行时现在会显示友好提示,不再静默挂起 (#154)- 修复部分组件(仅有子组件属性的组件)在
antd info中无法正常显示的问题 (#152) - 修复 v5/v6 中部分组件的属性元数据和 Token 数据缺失或格式错误的问题 (#138, #132, #122, #125)
- 修复 Markdown 表格输出中特殊字符转义不正确的问题 (#136)
- 修复传入无效的
--format或--lang值时被静默忽略而未报错的问题 (#141) - 修复版本解析、
antd upgrade版本比较和antd semantic --lang zh崩溃等问题 (#127)
安全#
其他变更#
- 排除 skills 的 node_modules,减小包体积 (#144)
- 新增 Codex 及 OpenAI Agents 支持 (#151)
- 提升数据同步流程的稳定性 (#155, #156, #135, #133)
- 升级依赖 (#149, #148, #130, #119, #117)
- 同步 antd 元数据至 v6.4.4 (diff)
6.4.3 (2026-05-18)#
Bug Fixes#
- Fix async
postActionhook not being properly awaited — useparseAsync()instead of synchronousparse()(#113) - Fix semver OR-range (
||) false positives in peer dependency checks and incorrect^0.xminor-locking behavior by replacing hand-rolled semver parser with thesemverpackage (#109) - Fix CJK character width misalignment in table output (e.g.
antd list --lang zh) usingstring-width(#109) - Fix
compare()returning incorrect results for null/undefined inputs (#111)
Other Changes#
- Replace custom Levenshtein distance and recursive directory walker with
fast-levenshteinandfast-globpackages (#109) - Extract shared
fetchWithTimeoutandfetchFirstJsonhelpers to eliminate duplicated HTTP patterns (#109) - Sync bundled antd CLI skill with current command surface (#114)
- Remove stale v6 snapshots and prevent re-accumulation, reducing package size by ~4.3 MB (29.6 MB → 25.3 MB) (#107)
- Convert e2e tests to in-process execution for better performance (#112)
- Reach 100% line, statement, and function test coverage (#115, #116)
- Update antd metadata (v6@6.4.3)
6.4.2 (2026-05-14)#
- Update antd metadata (v6@6.4.2)
6.4.1 (2026-05-14)#
- Update antd metadata (v6@6.4.1)
6.4.0 (2026-05-14)#
New Features#
doctorcommand now checks for known bugs in the installed antd version and displays related issue links (#89)
Bug Fixes#
- Fix lint false positives for
Checkbox.Group/Radio.Group—valueonCheckboxinsideCheckbox.GroupandoptionTypeonRadioinsideRadio.Groupare no longer incorrectly warned (#93, closes #91) - Fix lint performance rule incorrectly flagging locale default imports like
import enUS from 'antd/locale/en_US'and improve suggestion to use actual component names instead of always suggestingButton(#104, closes #99, #101)
Other Changes#
- Refactor update check to query multiple sources concurrently (#89)
- Update antd metadata (v6@6.4.0)
- Configure Dependabot for grouped updates as npm ecosystem (#102)
- Bump dependencies and resolve security alerts (#103, #105)
6.3.7 (2026-04-27)#
- Update antd metadata (v4@4.24.16, v5@5.29.3, v6@6.3.7)
6.3.6 (2026-04-17)#
New Features#
- Add antd v3 support —
antd list,antd info,antd doc,antd demo,antd migrate 3 4now work with v3 projects (#77) - Add
--antd-aliasflag toantd lintfor recognizing wrapper import sources (#81) - Enhance
antd envwith full envinfo output (#75) - Add MCP tool annotations for better IDE integration (#79)
Bug Fixes#
- Fix
antd tokenoutputting plain text instead of valid JSON when no tokens available (#80) - Fix sync workflow never detecting new antd versions (#83)
- Fix AI assistant proactively suggesting bug reports; bug reporting is now user-initiated only, with
ANTD_NO_AUTO_REPORT=1to fully opt out (#85, closes #82)
Other Changes#
6.3.5 (2026-03-30)#
New Features#
- Add
antd envcommand — prints a full environment snapshot including Node.js, OS, browser, antd version, package manager, and build tool. Useful for bug reports and AI agent context.
Bug Fixes#
- Fix
antd lintreporting incorrect line numbers (always showing line 0) (#65)
Other Changes#
- Update antd metadata (v6@6.3.5)
- Bundle all dependencies into the package — eliminates 180+ transitive packages from your
node_modules(#64)
6.3.5-beta.0 (2026-03-25)#
New Features#
- feat: add
antd mcpcommand — MCP server with 7 tools and 2 prompts for IDE integration (#38)
Bug Fixes#
- fix: run update check when using
-Vflag (#42) - fix(lint): rewrite all rules with oxc-parser AST analysis (#40)
- fix(lint): avoid false positives for deprecated prop rule on unrelated components (#36)
Other Changes#
- refactor: extract core functions from 7 command modules (#38)
- chore: keep JSON in git, exclude from npm via .npmignore (#41)
- ci: add npm pack size detection workflow and badge (#39)
- Update skill to instruct code agents to auto-update CLI when "Update available" notice appears (#42)
6.3.4 (2026-03-24)#
Bug Fixes#
- fix: show nameZh and since in info command output (#5)
- fix: restore missing name field in globalTokens for token command (#10)
Other Changes#
- Update antd metadata (v4@4.24.16, v5@5.29.3, v6@6.3.4)
- ci: switch to GitHub Actions OIDC publishing, remove NPM_TOKEN (#7)
- ci: migrate to semantic-release for automated versioning and publishing (#14)
- chore: simplify sync workflow (#11)
- chore: remove unused sample-data directory (#12)
6.3.3 (2026-03-24)#
First release of @ant-design/cli. A CLI tool for querying Ant Design component knowledge and analyzing antd usage in projects. Designed for AI code agents (Claude Code, Cursor, Copilot, etc.) with structured output support.
📚 Knowledge Query#
antd list— List all antd components with descriptions and categoriesantd info <Component>— Query component API: props, types, default values;--detailfor full docs, methods, FAQantd doc <Component>— Output full API documentation in markdownantd demo <Component> [name]— Browse and retrieve demo source codeantd token [component]— Query global and component-level Design Tokens (v5+)antd semantic <Component>— ShowclassNamesandstyleskeys for semantic customizationantd changelog [v1] [v2] [component]— View changelog entries or diff APIs across versions
🔍 Project Analysis#
antd doctor— Diagnose project configuration issues (React compat, duplicate installs, theme config, SSR)antd usage [dir]— Scan project for component usage statistics and sub-component breakdownantd lint [file/dir]— Check antd best practices (deprecated APIs, a11y, performance)antd migrate <from> <to>— Version migration guide with breaking changes and auto-fix support
🐛 Issue Reporting#
antd bug— Report a bug to ant-design/ant-design with auto-collected environment infoantd bug-cli— Report a bug to ant-design/ant-design-cli
✨ Highlights#
- 🧩 14 commands covering knowledge query, project analysis, and issue reporting
- 📦 Multi-version support: bundled metadata for antd v4, v5, v6 — fully offline
- 🎯 Per-minor-version snapshots for precise API data at any antd version
- 🔄 Auto-detect project antd version from
node_modulesorpackage.json - 🤖 All commands support
--format json|text|markdownand--lang en|zh - 🔮 Fuzzy matching with "Did you mean?" suggestions on typos
- 🔀 Cross-version API diffing (e.g. v4 vs v5)
- 🔗 Skill file for seamless integration with code agents (
npx skills add ant-design/ant-design-cli) - 🛡️ Standard error format with error codes and actionable suggestions