Wayland Core CLI (optional)

You probably already have this

Wayland Core is the engine the desktop app runs on, and the app bundles its own copy. If you installed the Wayland desktop app, Core is already there. You only need the steps below if you want the standalone wayland-core command-line tool to script Wayland, run it in CI, or drive a headless server. If you are just getting started with the desktop app, you can skip this page.

Install with npm

The published package is scoped as @ferroxlabs/wayland-core. The binary it installs is wayland-core.

Run it once without installing:

npx @ferroxlabs/wayland-core "Read package.json and summarize it"

Or install it globally:

npm i -g @ferroxlabs/wayland-core

The package depends on a per-platform binary and resolves the right one for your operating system and architecture during install. After it finishes, confirm the binary is on your path:

wayland-core --version

Build from source

If you would rather build it yourself, compile the Rust workspace in release mode:

cargo build --release

The binary lands at target/release/wayland-core.

Generate a config file

The standalone CLI keeps its own config. Create a starter config and then find where it lives:

wayland-core --init-config
wayland-core --config-path

Open the printed file and add a provider key, or sign in to Anthropic with OAuth:

wayland-core --login

Run it

With the config in place, run a one-shot prompt or open the interactive session:

wayland-core "List the largest files in this directory"
wayland-core

Next

• Desktop vs Core: Which Do I Use
• Wayland Core: Overview
• Configuration