Changelog#
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