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.
• Generate model comparison reports while comparing lane choices.

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

# Write a model comparison replay report
guildhall model-bakeoff

# Compare context-indexer candidates
guildhall model-bakeoff --context-indexer

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.
• Open model recommendations — current tested open-model lanes and comparison approach.