Offline example

Use this small fixture to try the CLI without your own manuscript, including from a wheel installation. After installing, run these commands in one POSIX shell. They create a fresh temporary directory; no TeX or PDF tools are needed.

demo_dir="$(mktemp -d)"
mkdir "$demo_dir/paper"
cat > "$demo_dir/paper/main.tex" <<'TEX'
\documentclass{article}
\title{A small paper}
\author{Example Author}
\date{}
\begin{document}
\maketitle
\begin{abstract}
A minimal project for checking a local source bundle.
\end{abstract}
\section{Introduction}
The source cites a book about TeX~\cite{knuth1984}.
\bibliographystyle{plain}
\bibliography{references}
\end{document}
TEX
cat > "$demo_dir/paper/references.bib" <<'BIB'
@book{knuth1984,
  author = {Donald E. Knuth},
  title = {The {TeXbook}},
  year = {1984},
  publisher = {Addison-Wesley}
}
BIB

Inspect it

fledge inspect "$demo_dir/paper" --main main.tex --isolated --offline
fledge bib check "$demo_dir/paper" --main main.tex --isolated --offline

Both commands should exit with code 0 and outcome passed. inspect also records a TEX009 not-applicable note because the demo has no generated .bbl; it does not change the outcome. Add --show-passed to list the individual results and notes. They inspect sources and bibliography only; no build or bundle is verified. --isolated ignores any configuration file, and --offline prevents network requests.

Save a report

fledge inspect "$demo_dir/paper" --main main.tex --isolated --offline \
  --quiet --output-format json --report "$demo_dir/inspection.json"
fledge rule BIB001

JSON also appears on stdout. The report guide explains it.

The source distribution includes a nested fixture too. From its root directory:

fledge inspect examples/nested-paper --main main.tex --isolated --offline

For your own manuscript, follow the quick start.