yqarch is a command-line utility and GitHub-hosted project for working with YAML (and often JSON) data that focuses on archiving, querying, and transforming structured configuration files. It sits in the ecosystem around tools like yq (mikefarah/yq and kislyuk/yq) but emphasizes workflows for storing, versioning, and extracting snapshots or specific fragments from YAML-heavy repositories and configuration stores.
The plugin introduces a suite of parametric tools tailored for architecture:
yqarch get path.to.key file.yaml
yqarch to-json file.yaml > file.json
yqarch snapshot configs/ --output snapshot.tar.gz
(Note: exact command names and flags vary by implementation; check the project’s README for precise syntax.) yqarch github
Once installed, these are the top 10 commands you must memorize. The GitHub Wiki (often linked from the repository) provides the full list.
| Command | Function | Time Saved | | :--- | :--- | :--- | | WW | Draw double-line wall with automatic clean-up | 80% | | AA | Intelligent door insertion (auto-flip) | 70% | | 3D | Convert 2D plan to basic 3D extrusion | 90% | | MJ | Calculate total area of a closed polyline | 95% | | TCG | Create ceiling grid with dimensions | 85% | | DD | Dim-scale (automatic dimension based on viewport) | 60% | | SS | Layer isolation (hide all but selected object) | 50% | | RF | Rectangular array with dynamic spacing | 75% | | CJ | Create elevation marker with automatic annotation | 90% | | BG | Draw stairs and railings (basic) | 70% | yqarch — an informative overview yqarch is a
Pro Tip: Type YQSETTINGS to customize the default wall thickness, door sizes, and layer prefixes to match your office standard.
Before touching anything, yq-arch verifies: Wall Tools: Draw single and double-line walls with
If any check fails, the operation stops with a clear warning.
git clone https://github.com/yqlbu/yq-arch.git
cd yq-arch
chmod +x yq-arch
sudo cp yq-arch /usr/local/bin/
Then just run:
yq-arch upgrade