用途：让脚本与智能体通过命令行调用 xAI 的 REST API，兼容其他提供方，面向 JSON 优先、可管道化的自动化场景。
主要能力：提供模型选择与能力矩阵（model-picker、model-capabilities）、成本预估（cost-preview）、小请求连通性验证（smoke-chat）、API 密钥健康检查（api-key）等特色命令；覆盖 chat、completions、embeddings、files、images、videos、responses、messages、documents、models 等接口。输出带 meta.source（live 或 local）的来源信封，解析 .results 取数据。
使用方式：需先安装 CLI，安装命令为 npx -y @mvanhorn/printing-press-library install xai --cli-only，验证 xai-pp-cli --version；失败可回退 go install github.com/mvanhorn/printing-press-library/library/ai/xai/cmd/xai-pp-cli@latest。鉴权先运行 xai-pp-cli auth setup，再 xai-pp-cli auth set-token YOUR_TOKEN_HERE，或设置 XAI_API_KEY 环境变量，并用 xai-pp-cli doctor 验证。任意命令可加 --agent（等价于 --json --compact --no-input --no-color --yes），支持 --select 筛选字段、--dry-run 预览、--deliver 指定 stdout/file/webhook 输出、命名 profile 复用参数；可用 xai-pp-cli which 用自然语言定位命令。MCP 安装：claude mcp add xai-pp-mcp -- xai-pp-mcp。
适用场景：需要为智能体选择有效模型 ID、估算 token 成本、检查密钥权限、或从脚本批量调用 xAI 文本、图像、视频、嵌入接口时。
限制：complete/completions 为旧版接口，reasoning 模型不支持；videos 编辑为异步操作需轮询；需将安装目录加入 PATH 才能被运行时调用；webhook 失败返回非零；feedback 默认仅本地存储，除非设置 XAI_FEEDBACK_ENDPOINT 并启用发送；其余平台与收费信息暂未提供。