gwz-cli

gwz serves as the primary command-line interface for GWZ (Git Workspace Zone), a system designed to coordinate multiple standard Git repositories into one reproducible workspace. Unlike monorepo tools that merge code, gwz maintains each member repository as a normal Git repository while recording the root's composition and exact state. This allows users to manage complex project structures with precise version control across distributed components. The tool is available for installation on macOS, Linux, and Windows via provided installer scripts. It functions by parsing command-line arguments and sending typed requests to the underlying `gwz-core` library, which handles the message-driven coordination. The CLI supports various output formats including human-readable text, porcelain, JSON, and JSONL, making it suitable for both interactive terminal use and programmatic integration. Key features include: - **Workspace Coordination**: Manages relationships between multiple Git repositories as a unified zone. - **Reproducibility**: Ensures the entire workspace state can be reproduced exactly from the root configuration. - **Standard Git Compatibility**: Member repositories remain fully functional and independent Git repos. - **Cross-Platform Support**: Official installers for major operating systems. For development, the project uses Rust (Cargo) and Python for documentation generation. It is licensed under GPL-2.0-only, aligning with Git's licensing family. Users are encouraged to consult the full user documentation for detailed workflows, lifecycle management, and troubleshooting guides.