# 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 opening order, including floating and hidden stack members. Make-primary exchanges the visible window with the primary without resetting dividers. Reset-sizes restores divider sizes to the configured ratio, not gaps or floating frames. `set-window-cap` accepts `0`–`100`; `0` means unlimited. Close asks the window’s app to close, preserving its save prompts. Retile reports windows whose movement was confirmed by fresh frame readback, not just requested. Feedback waits at most five seconds after applying the command; under continuing window activity, it reports only movement confirmed so far. Unconfirmed work can finish later without delaying the reply or reporting twice. `prcl run` forwards an engine command and its arguments. Put `--json` before the forwarded command; everything after it passes through unchanged. See [configuration](configuration.md) for available layouts and bindings. ## Default command shortcuts Many commands also have shortcuts. See [configuration](configuration.md#shortcuts-and-motion) for the default bindings, other prefixes, and system shortcut conflicts. ## Native Spaces Use `space-focus N`, `space-next`, `space-previous`, or `space-back-and-forth` to switch. `window-to-space N`, `window-to-space-next`, and `window-to-space-previous` move the focused window and accept `--follow`. These commands use enabled Mission Control shortcuts. Desktop numbers are the system’s 1–16 numbers, not Space IDs, and targets must be on the active display. Moves return to the original Space unless you use `--follow`. There are no named virtual-workspace commands, and Space commands have no default bindings. ## Events and integration `subscribe` watches `focus`, `layout`, `workspace`, and `window` topics. Events have no replay; slow subscribers are disconnected instead of accumulating work. Query current state after a notification rather than treating events as a log. The [IPC guide](../Sources/ParcelIPC/ParcelIPC.docc/ParcelIPC.md) covers the versioned JSON wire format and transport APIs. [Callbacks](callbacks.md) run scripts in response to events. [Layout memory](../Sources/ParcelEngine/ParcelEngine.docc/LayoutMemory.md) covers inspect, save, reset, and undo.