Skip to content

Serve

ctx

ctx serve

Serve a static site locally via zensical.

With no argument, serves the journal site at .context/journal-site. With a directory argument, serves that directory if it contains a zensical.toml.

ctx serve                             # Serve .context/journal-site
ctx serve ./my-site                   # Serve a specific directory
ctx serve ./docs                      # Serve any zensical site

This command does NOT start a hub

ctx serve is purely for static-site serving. To run a ctx Hub for cross-project knowledge sharing, use ctx hub start. That command lives in its own group because the hub is a gRPC server, not a static site.

Requires zensical to be installed:

pipx install zensical

Arguments

Argument Description
[directory] Directory containing a zensical.toml to serve

When omitted, serves .context/journal-site by default — the directory produced by ctx journal site.

Examples:

ctx serve                         # Default: serve .context/journal-site
ctx serve ./my-site               # Serve a specific directory
ctx serve ./docs                  # Serve any zensical site

See also