Something went wrong. Try again.
An auto tiler for macOS
Something went wrong. Try again.
# 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…