The CLI turns the public guide corpus into a stable local interface. It is useful when a maintainer needs to inspect metadata, an organizer wants an offline-readable page, or an automation needs structured routing without scraping rendered HTML.
Install (local)
Prereqs:
- Node
22+ pnpm
git clone https://github.com/unionize-software/unionize.software.git
cd unionize.software
pnpm install
What you can do
- lists guides
- reads guide pages by slug
- searches guides by query and optional tag
- exposes the Start Here schema
- runs the pathfinder from structured JSON input
Guide output comes from the same content model that powers the website. A slug, jurisdiction, review status, or related-guide link therefore does not need to be reconstructed from page markup.
Example commands
pnpm unionize guides list
pnpm unionize guides search "retaliation" --tag retaliation
pnpm unionize guides read workplace-mapping
pnpm unionize start schema --json
To inspect the options before passing structured input, start with the schema command. Treat pathfinder output as routing into public material, not as an individualized legal determination.
If you prefer the bin wrapper directly:
node bin/unionize-software.mjs guides list
Intended boundary
The guide and Start Here commands read public project content. They do not expose encrypted intake or a private worker workspace.
The broader executable also contains operator-only intake commands documented in the repository README. Those commands use a local organizer cache and require separate credentials or key material. Public-content automation should not assume access to them, and agents should never request or print private keys.
Verify the installation
Run one list and one read command. You should receive the catalog and the body of the named guide without starting the web application:
pnpm unionize guides list
pnpm unionize guides read safety-basics
If a consumer depends on fields rather than prose, use JSON-capable commands where available and pin the repository or package version. Human-facing copy will continue to improve; the content model is the integration surface.