CLI Subcommand Reference

Beyond the default agent and REPL, wayland-core exposes focused subcommands. A subcommand short-circuits the agent path and runs its own action. Run wayland-core <command> --help for the details of any one.

models

Inspect the bundled model catalog.

Command	Description
`models list`	List known models as `provider/model_id`, one per line.
`models list --provider <P>`	Filter to a single provider, for example `openai` or `anthropic`.

plugin

Manage installed plugins from the marketplace.

Command	Description
`plugin install`	Install a plugin.
`plugin list`	List installed plugins.
`plugin available`	List plugins available to install.
`plugin remove`	Remove an installed plugin.

mcp-serve

Serve the engine’s tool registry as an MCP server (stdio or SSE), so external MCP clients such as Claude Desktop can call Wayland Core’s tools.

wayland-core mcp-serve

swarm

Dispatch a worktree-isolated worker swarm across a repository.

# Inline flags:
wayland-core swarm --workers 4 --repo . --worker-command "<cmd>" --task "label"

# Or a TOML brief file, which overrides the inline flags:
wayland-core swarm --workers 4 --repo . --brief swarm.toml

--brief takes a path to a TOML brief file. When given, it overrides the other inline flags rather than pairing with them.

Key options: --workers, --repo, --brief, --task, --base-branch, --branch-prefix, --worker-command, --timeout.

workflow (alias: forgeflows)

Validate, list, and run saved RON ForgeFlows from .wayland/workflows/.

Command	Description
`workflow validate`	Validate a ForgeFlow document.
`workflow list`	List saved workflows.
`workflow run`	Run a workflow.

project-context

Print the resolved project context, walking up from the current directory through WAYLAND.md, AGENTS.md, .wayland/context.md, and CLAUDE.md.

wayland-core project-context

init

Scaffold .wayland/config.toml and a WAYLAND.md in the current directory.

wayland-core init

acp

The Agent Client Protocol surface. acp serve binds the HTTP and SSE transport; acp request drives a one-shot session and message round-trip. This is how the desktop app talks to the engine.

Command	Description
`acp serve`	Bind the ACP server transport.
`acp request`	Drive a one-shot session/message round-trip.

agent

Manage user-defined agents. Built-ins from the bundled pack are read-only.

Command	Description
`agent create`	Create an agent. Accepts a body via `@file`.
`agent list`	List agents. Add `--builtins` to include the built-in pack.
`agent show`	Show an agent definition.
`agent edit`	Edit an agent.
`agent delete`	Delete an agent (confirm with `--yes`).

cron

Manage scheduled jobs. Jobs persist to $WAYLAND_HOME/cron/jobs.json; a background runner started at session boot picks up changes on its next tick.

Command	Description
`cron add <expr>`	Add a job. Target one of `--slash`, `--channel` (with `--text`), or `--skill` (with `--args`).
`cron list`	List jobs.
`cron remove`	Remove a job.
`cron enable`	Enable a job.
`cron disable`	Disable a job.
`cron status <id>`	Print full details for one job.
`cron history <id> [--limit N]`	Print the last N fire records (default 20).
`cron logs <id> [--limit N]`	Tail recent log lines (default 50).

self-update

Update to the latest signed release. Verifies the signature (ed25519) against a pinned key before swapping the binary.

Command	Description
`self-update`	Update to the latest signed release.
`self-update --check-only`	Print current vs. latest version without installing.

setup

Launch the TUI on the onboarding (connect and configure) surface, even when a config already exists. Onboarding handles an existing config with an overwrite-or-keep choice.

wayland-core setup

auth

Manage provider API keys directly in the global config.toml, a lightweight alternative to full onboarding.

Command	Description
`auth list`	List configured providers.
`auth add`	Add a provider key.
`auth remove`	Remove a provider key.