CLI

The browser UI is the main way to use Guildhall. The CLI is the companion path for service lifecycle, project registry work, and the kind of narrow debugging session that is easier in a terminal than in the project shell.

Use the CLI when you want to:

• Start or stop a controlled runtime tick from a terminal.
• Start or stop the background local service, or reopen it on a specific path.
• Register, list, or unregister projects in the local service registry.
• Run setup without automatically opening a browser.

Common workflows

# Open the browser UI for the current project
guildhall serve

# Run one controlled orchestrator tick
guildhall run --domain ui --max-ticks 1

# Register an existing project
guildhall register ~/projects/my-app

Command reference

See the CLI reference for every command, flag, and example.

Related docs

• Quick start — browser-first setup and first task.
• Running Guildhall — browser run controls first, CLI run commands second.
• Environment variables — runtime configuration knobs.