lifecycle
lifecycle gave the tidyverse the word superseded, then spent years tuning who gets warned
Comparison · Infra & APIs
cli vs pkgdown
A side-by-side editorial comparison of cli and pkgdown — release velocity, themes, recent moves, and the top alternatives to consider.
cli vs pkgdown: at a glance
What is cli?
cli refines terminal output one formatting detail at a time.
cli builds the formatted terminal output used across r-lib and the tidyverse — inline styles, progress bars, hyperlinks, pluralization. Every release in this window is small and specific: number and byte styles, pluralization that copes with NA and infinities, collapse behaviour that obeys serial comma rules.
What is pkgdown?
pkgdown now generates llms.txt and a markdown copy of every documentation page
pkgdown builds the documentation sites for most R packages. The 2.1 line was about format and appearance - Quarto vignettes, a light and dark switch, self-hosted assets instead of CDN fetches. The 2.2 line changed audience: build_llm_docs() emits an llms.txt at the site root and a markdown version of every page, on by default.
cli vs pkgdown: editorial side-by-side
cli
0.0INFRA · APIS
cli refines terminal output one formatting detail at a time.
◆ Current state
cli builds the formatted terminal output used across r-lib and the tidyverse — inline styles, progress bars, hyperlinks, pluralization. Every release in this window is small and specific: number and byte styles, pluralization that copes with NA and infinities, collapse behaviour that obeys serial comma rules.
◆ Where it's heading
The work splits in two. One half is expressiveness, adding inline style classes for value types packages format constantly. The other is environment compatibility, where cli must work out what the surrounding terminal or IDE actually supports — hyperlink URI generation became configurable rather than fixed, and hyperlinks are disabled where the host renders them badly.
◆ Prediction
Expect more inline style classes and further environment detection work as editors like Positron and RStudio change how they render terminal output.
pkgdown
0.0INFRA · APIS
pkgdown now generates llms.txt and a markdown copy of every documentation page
◆ Current state
pkgdown builds the documentation sites for most R packages. The 2.1 line was about format and appearance - Quarto vignettes, a light and dark switch, self-hosted assets instead of CDN fetches. The 2.2 line changed audience: build_llm_docs() emits an llms.txt at the site root and a markdown version of every page, on by default.
◆ Where it's heading
Two audiences are now being served from one build. Human-facing work continues in small increments - dark-mode plot filtering, new translations, a local http server so search works in preview - while the new machine-facing output is opt-out rather than opt-in. The default matters more than the feature: thousands of package sites will start emitting llms.txt without their maintainers choosing to.
◆ Prediction
Expect the markdown output to gain the same configuration surface the HTML has, and the llms.txt contents to get more selective as maintainers discover what ends up in it; a way to exclude individual pages is the obvious next request.
Alternatives to cli and pkgdown
Other Infra & APIs products tracked by Sparkpulse, ranked by recent ship velocity. Each card links to a full editorial trajectory and lets you pivot into a head-to-head comparison with either cli or pkgdown.
waldo
waldo keeps shedding dependencies while teaching its diff engine new object systems
usethis
usethis swaps in the Air formatter and stops assuming RStudio is the editor
knitr
knitr adds OpenTelemetry tracing, turning document builds into observable pipelines
lintr
lintr makes the native pipe the default rule and clears out a decade of deprecations
covr
covr's coverage tooling has been stable to the point of dormancy since 2022
Recent activity from cli and pkgdown
Latest ship moves from both products, interleaved chronologically. ⚡ = editorial spark.
- 1mo agopkgdownLocal preview served over http so search works
- 4mo agoclicli 3.6.6 adds inline number and byte formatting styles
- 9mo agopkgdownbuild_llm_docs() emits llms.txt and markdown for every page ⚡
- 1y agopkgdownMenu items accept class and id attributes
- 1y agopkgdownROR IDs, Codeberg support, bslib navbar variables
- 1y agoclicli 3.6.5 handles long strings in code_highlight()
- 1y agoclicli 3.6.4 makes hyperlink URIs configurable
- 1y agopkgdownKeyboard shortcut for search; clean_cache() added
- 2y agopkgdownQuarto vignettes, light/dark switch, self-hosted assets
- 2y agoclicli 3.6.3 builds on ARM Windows, fixes RStudio highlighting
- 2y agoclicli 3.6.2 makes collapsed strings follow serial comma rules
- 3y agoclicli 3.6.1 disables ANSI hyperlinks on the RStudio render plane
Frequently asked questions
What is the difference between cli and pkgdown?
They serve adjacent needs but don't currently overlap on shipped themes. cli and pkgdown are shipping at a similar cadence (velocity 0.0 vs 0.0, both within Sparkpulse's "active" band). See the at-a-glance table above for a side-by-side breakdown of velocity, recent sparks, and editorial themes.
Is cli better than pkgdown?
Sparkpulse doesn't pick a winner — we score release velocity, not feature parity. cli and pkgdown are shipping at a similar cadence (velocity 0.0 vs 0.0, both within Sparkpulse's "active" band). For your specific use case, the alternatives sections above list other Infra & APIs products to evaluate alongside.
What are the best alternatives to cli?
Top cli alternatives in Infra & APIs are ranked by recent ship velocity. Browse the "cli alternatives" section above for the current picks, or visit /alternatives/cli-r for the full list with editorial commentary on each.
What are the best alternatives to pkgdown?
Top pkgdown alternatives in Infra & APIs are ranked by recent ship velocity. Browse the "pkgdown alternatives" section above for the current picks, or visit /alternatives/pkgdown for the full list with editorial commentary on each.