An auto tiler for macOS
parcel docs command-line.md
4.3 kB · 98 lines
Markdown
at main

# Command line The `prcl` CLI is bundled at `Parcel.app/Contents/Resources/bin/prcl`. For a development build, that’s `build/Parcel.app/Contents/Resources/bin/prcl`. Add the containing directory to your shell’s `PATH` if you want to type `prcl`. Most commands talk to the running app over a user-only Unix socket. The CLI never launches the app. Help, `version`, `schema`, and `config check` work offline. ```sh prcl query windows --json prcl layout side prcl focus left prcl why 123 prcl diagnostics prcl reload prcl subscribe --json prcl run balance prcl make-primary prcl window-next prcl set-window-cap 3 prcl toggle-automatic-tiling prcl reset-sizes prcl close prcl toggle-fullscreen prcl undo prcl --help ``` Use a window ID from `query windows` for `why`. Use `--json` for scripts. `PARCEL_SOCKET` overrides the CLI’s socket path; it must be absolute and fit the Unix socket limit of 103 UTF-8 bytes. ## Checking configuration `prcl config check` validates the local configuration without connecting to Parcel. Use `--path FILE` to check another file, and `--json` for diagnostics in scripts. A missing file validates the defaults without creating a file. Read failures, invalid UTF-8, and invalid configuration still fail; warnings leave the exit code successful. ## Setups `prcl setup list`, `save NAME`, `open NAME`, and `delete NAME` use the app’s saved catalog, loading it first if necessary. Quote names containing spaces. Name lookup ignores case and surrounding whitespace and treats canonically equivalent Unicode spellings as the same name. `save NAME --no-hide` leaves other apps visible. See [Setups](../Sources/ParcelEngine/ParcelEngine.docc/Setups.md) for opening and recovery. ## Automatic tiling `prcl toggle-automatic-tiling` switches automatic arrangement on or off. When off, Parcel observes windows but never moves them on its own. Explicit shortcuts, menu commands, and CLI commands still work. `prcl query config` reports the positive `automatic_tiling` flag. ## Rearranging windows Window cycling follows o…