gwz-cli

gwz 是 GWZ（Git Workspace Zone）的主要命令行界面，该系统旨在将多个标准 Git 仓库协调为一个可复现的工作区。与合并代码的 monorepo 工具不同，gwz 将每个成员仓库保持为普通 Git 仓库，同时记录根仓库的组成和精确状态。这使用户能够管理复杂的项目结构，并在分布式组件之间实现精确的版本控制。 该工具可通过提供的安装脚本在 macOS、Linux 和 Windows 上安装。它的工作方式是解析命令行参数，并向底层的 `gwz-core` 库发送类型化请求，由该库处理消息驱动的协调。CLI 支持多种输出格式，包括人类可读文本、porcelain、JSON 和 JSONL，因此既适合交互式终端使用，也适合程序化集成。 主要功能包括： - **工作区协调**：将多个 Git 仓库之间的关系作为统一区域进行管理。 - **可复现性**：确保整个工作区状态可以从根配置精确复现。 - **标准 Git 兼容性**：成员仓库仍保持完全可用且独立的 Git 仓库。 - **跨平台支持**：为主要操作系统提供官方安装程序。 在开发方面，该项目使用 Rust（Cargo）和 Python 进行文档生成。它采用 GPL-2.0-only 许可证，与 Git 的许可证家族保持一致。鼓励用户查阅完整用户文档，以了解详细工作流、生命周期管理和故障排除指南。