X-CMD

项目概述#

X-CMD 是一个为 POSIX Shell 设计的现代化模块化工具集，通过纯 Shell 和 AWK 实现，致力于为命令行环境提供媲美 Python 标准库的基础能力。项目当前迭代至 v0.8.14 版本，采用 Apache License 2.0 协议开源，由 lj h.sh (edwinjhlee) 创建，背后机构为 MiraclePlus。

核心系统#

模块系统 — 300+ Shell/AWK 函数库#

• 追求最大可移植性，覆盖 BusyBox、Alpine、legacy 机器等极简环境
• 调用方式：x <module>
• 覆盖领域：
  • AI 接入：openai, gemini, deepseek, kimi, ollama, mistral, whisper 等
  • Agent 封装：claude, codex, opencode
  • OS 管理：增强的 mac, top, ps, df, free, stat, hash
  • 文件系统：ls, path, zuz（智能解压）
  • Git 增强：gh, gt, gl, cb
  • 云服务：bwh, shodan, aws ec2 (WIP), ali ecs (WIP)
  • 消息通知：feishu, dingtalk, telegram, discord, weixin
  • 信息查询：tldr, man, cht, rfc, wkp (Wikipedia), osv
  • 体验增强：theme（跨 Shell 主题）, advise（6+ Shell 补全）
  • 其他：githook（husky 替代）, ccal（农历/日历）, str, csv

包系统 — 600+ 便携 CLI 工具#

• 收集并审校第三方开源 CLI 工具（jq, fzf, fd, ripgrep, node, python 等）
• 预编译二进制（Go, Rust, C 等），按需下载、无需 root、不污染系统
• 三种使用模式：
  • x <tool>：直接使用（自动检测，缺失则静默安装便携版）
  • x env use <tool>：全局安装到用户环境
  • x env try <tool>：临时安装（仅当前 shell 会话有效）

统一软件安装#

• 抽象 1200+ 软件安装配方，屏蔽 brew/apt 等不同平台包管理器差异
• 一条命令 x install <soft> 自动选择最佳安装路径

AI-Native Shell 与 Agent 能力#

• 仅需 shell + curl 即可接入 OpenAI、Gemini、DeepSeek、智谱、MiniMax、Kimi、Mistral、Jina、Ollama 等多家 LLM 提供商
• 内置体积 < 2MB 的纯 Shell 实现 AI Agent
• 提供 200+ AI Skills 增强上下文感知（x skill ll / x skill suggest / x skill add）
• 利用 AWK 进行 LLM 流式输出处理，在应对网络延迟和吞吐瓶颈时具备原生 Shell 集成优势
• 为 AI Agent（Claude Code、Codex、Gemini CLI 等）提供 1000+ CLI 工具知识，自动安装缺失工具

架构设计#

• 核心依赖：完全基于 POSIX Shell + AWK 编写，零外部依赖
• 仓库结构：入口文件为 X（核心 Shell 函数），模块存放于 mod/，附加模块位于 adv/
• 智能检测：执行 x <tool> 时优先检测系统 PATH，缺失则静默下载便携版
• 优雅降级：高级工具或网络不可用时，自动衰退至仅依赖 POSIX Shell + AWK 的核心功能
• 输出自适应：TTY 模式输出交互式 TUI 或彩色结构化文本；Pipe 模式输出 TSV 或 JSON（--json 标志）
• 设计哲学：Modules 类比 JS（原生、轻量、随处运行），Packages 类比 WebAssembly（预编译、强大、按需加载）

性能指标#

• 核心体积约 ~1.1 MB
• 非交互加载耗时 < 20 ms，交互加载耗时 < 60 ms

平台支持#

• Linux、macOS、Windows (WSL/Git Bash/PowerShell)、BSD
• 同时支持 Fish、Nushell、Elvish、Xonsh、tcsh 等非 POSIX Shell

安装与使用#

# 快速安装
eval "$(curl https://get.x-cmd.com)"

# 包管理器安装
brew install x-cmd
sudo yay -S x-cmd

# 升级与卸载
x upgrade
x uninstall self

# 加载
. ~/.x-cmd.root/X

Windows PowerShell 需下载 x-cmd.bat 运行；Fish/Nushell 等参考官网专门指南。

典型应用场景#

• AI Agent Shell 增强：为 Claude Code、Codex 等提供即时工具赋能
• 最小环境部署：BusyBox、Alpine、Docker 容器中零配置运行
• 跨平台一致性：Linux/macOS/Windows 间统一命令行体验
• 系统运维：增强的 docker、ps、top、df 等，支持 TUI 和结构化输出
• 信息速查：x tldr、x rfc、x wkp 快速查阅文档与规范
• 通知集成：飞书、钉钉、Telegram、Discord、微信消息推送

待确认信息#

• 首次发布时间未明确标注，官网称 "5 years of shell best practices"
• 完整贡献者数量需查看 GitHub Insights
• AWS/阿里云 ECS 模块标注为 WIP，完成度未知
• 600+ 包完整清单需运行 x env ll 验证
• "纯 shell agent < 2MB 可比拟 OpenClaw 和 Claude Code" 属项目方宣传，无独立第三方评测