Building

texforge build

Compiles the project to <title>.pdf in the project root:

1. Copies sources into a temporary build directory (originals are never modified).
2. Renders embedded diagram environments to PNG.
3. Invokes Tectonic on the entry point declared in project.toml and places the resulting PDF (named after the document title) in the project root.

On the first run texforge downloads the Tectonic binary into ~/.texforge/bin/ automatically.

Watch mode

texforge build --watch watches .tex files and rebuilds automatically:

texforge build --watch            # rebuild after 2s of inactivity (default)
texforge build --watch --delay 5  # custom debounce delay in seconds

The terminal shows a live session timer, build count and the result of the last build. Press Ctrl+C to stop.

Cleaning

texforge clean   # remove build artifacts

Runtime directory

Texforge keeps its engine and template cache under ~/.texforge/:

~/.texforge/
  bin/
    tectonic            # LaTeX engine (auto-installed on first build)
  templates/
    general/            # cached templates
    apa-general/
    ...

Deleting this directory is safe: everything is re-downloaded on demand.