Skip to content

usethis

3.2.2Package record

Automate Package and Project Setup

86packages dependsuggested by 210
2.8Mdownloads / year
52.9%test coverage
13/13flavors OK

Overview

About

Automate package and project setup tasks that are otherwise performed manually. This includes setting up unit testing, test coverage, continuous integration, Git, 'GitHub', licenses, 'Rcpp', 'RStudio' projects, and more.

Changes in 3.2.2

AI coding agents

  • use_tidy_agents() is an experimental helper to set up an R package to work with AI coding agents in the same way as the tidyverse team (#2195, #2239).
  • learn_tidy_skill() is an experimental new function that prints instructions for performing a specialized R package development task (like deprecating a function) the way the tidyverse team does. It's primarily designed to be called by AI coding agents, as directed by the AGENTS.md created by use_tidy_agents().

Git and GitHub

  • create_from_github() now installs package dependencies by default, so you're set up to immediately start working on the package. Use install_dependencies = FALSE to suppress (#2186).
  • pr_init() and other functions that check for uncommitted changes now offer to stash and re-apply the changes or to retry, in addition to the existing options to proceed or cancel (#1300).
  • pr_merge_main() and other functions that report merge conflicts no longer offer to open the conflicted files in Positron (#2157).
  • pr_pull(), pr_push(), and friends now give more informative errors if usethis can't retrieve details about a remote (#1929, #2229).
  • pr_resume() (without a specific branch) and pr_fetch() (without a specific number) no longer error when a branch name contains curly braces (#2107, @jonthegeek).
  • use_git() now works in a directory that is not yet recognized as a usethis project: it assumes you want to initialise a Git repository in the current working directory (#2242).

Documentation

  • use_readme_qmd() creates a starter README.qmd with Quarto-flavored YAML frontmatter, analogous to use_readme_rmd() (#1671). Thanks @VisruthSK for getting the ball rolling.
Show all changes in 3.2.2Hide the rest of the changes in 3.2.2
  • use_description() and use_roxygen_md() now record the roxygen2 version in the Config/roxygen2/version field (instead of RoxygenNote) when roxygen2 >= 8.0.0 is installed (#2226).
  • use_import_from() works in packages that use roxygen2 >= 8.0.0 (@JesseAlderliesten, #2234).

Other

  • More messages and documentation refer to "RStudio or Positron" instead of just "RStudio", when the functionality applies to both IDEs (#2182).
  • use_env_var() is a new function that sets an environment variable in .Renviron, prompts for the value securely via askpass::askpass(), and activates it in the current session via Sys.setenv() (#2201, @gadenbuie).
  • use_course(), use_zip(), and use_github_action() no longer emit download or pagination progress when the usethis.quiet option is TRUE.
  • use_pipe() is deprecated (@math-mcshane, #2124).
  • use_release_issue() points first-time submitters to devtools::check_doc_fields() to verify that exported functions document their return values (#2241).
  • use_tidy_upkeep_issue() no longer includes the deprecated use_tidy_style() in the upkeep checklist (#2197, @edgararuiz).

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 7.9 min · r-release-windows-x86_64
Status changes
  • OK13 OK2026-08-04
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK13 OK2026-06-09
  • ERROR12 OK, 1 ERROR2026-06-07
  • OK14 OK2026-03-10
Advisories

none known

Documentation

In release 3.2.2
READMEYes · 252 wordsVignettesNoNEWSYes · 100% structured · mentions 3.2.2Citation fileNoWebsiteYes · pkgdown

The repository also keeps web-only articles.

Help pages
92 (10 internal)includes a package overview page
Examples that run
11%6 run in a plain check · 48 never run
Exported functions with examples
60%
Documented parameters
93%
Return-value docs
24%
Help pages citing references
0%

Downloads

2.8M
CRAN downloads in the past year
Rank #214 · ~7.6K/day · ~230.2K/mo
Daily download trend is not available in this view yet.
222.8K30 days
684.7K90 days
2.8M1 year
Compare downloads with other packages →
Also on112.7K r2u132 autocran226.4K conda_forge2.7K c2d4u

Repository

924Stars
313Forks
61Open issues
24Open PRs
26Releases
3,028Commits
179Commit identities
rsetuppackagegithubrstats
3,028 commits · Last activity 2026-10-15 · +0.2% stars, 30d · Default branch at 3.2.2.9000, ahead of CRAN 3.2.2 (checked 2026-10-11)
Responsiveness
How these are sampled
PRs merged (all time)
81%
Median days to close, 50 most recently updated closed issues
58
Median days to close, 50 most recently updated closed PRs
2

Stars over time

2025-10-04 · 8832026-10-09 · 924
PracticesBeta

20 development-tooling and community-health practices detected across 7 families in the upstream repository

Checks run against github.com/r-lib/usethis on 2026-10-11.

Continuous integration (2)
GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel

Governance and community (5)
Code of conductContributing guideIssue templatesCODEOWNERSSupport guide
Docs source (4)
README.Rmdpkgdown

GitHub Pages site last deployed 2026-09-22 · The repository has a site deploy workflow

pkgdown site last built 2026-09-11

Coverage (2)
Coverage reporting (Codecov).covrignore
Show all practicesHide 3 practices
CRAN release process (2)
cran-comments.mdrevdep/
For agents and models (1)
Agent skills
Lint, format, editor (4)
Lint workflowAirVS CodeRStudio project
How this is detected·Detection ruleset v3 (2026-09-26)
AI coding toolsBeta

This repository shows signs of AI coding tools.

  • Claude Codefirst seen 2026-02-03
    Seen in the repository: .claude
    Named in .Rbuildignore: .claude
Shared conventions any agent may read, so they name no particular tool.
Seen in the repository: AGENTS.md
How this is detected·Detection ruleset v4 (updated 2026-09-27)

Dependencies

Declared dependencies
30 external dependencies (excludes base and recommended)

Installing usethis adds 31 packages (17 with compiled code, 13 MB of source tarballs). Heaviest: pak 3.8 MB, fs 1.4 MB, openssl 1.1 MB.

Depends (1)
R >= 4.1
LinkingTo (0)
none
Enhances (0)
none

People & History

People (5)
Author, Maintainer since 1.5.0 (2019) · added in 1.2.0
Author · added in 2.1.0
Author · added in 2.2.0
Copyright holder, Funder · added in 2.2.0

Previously maintained by Hadley Wickham (1.0.0 to 1.4.0).

Listed in earlier versions (1)
RStudio
no longer listed · 1.0.0 to 2.1.6
Releases (26)

Pick two releases to compare their code metrics.

  • 3.2.2Latest
    record
    2026-09-10 · current release · diff ↗ ·
    added 4 exports
    learn_tidy_skill, use_env_var, use_readme_qmd, use_tidy_agents
  • R
    R 4.6.0 released · 2026-04-24
  • 3.2.1
    record
    2025-09-06 · diff ↗
  • 3.2.0
    record
    2025-08-28 · diff ↗ ·
    removed 8 exports
    git_branch_default, use_github_action_check_full, use_github_action_check_release, use_github_action_check_standard, use_github_action_pr_commands, use_github_actions, use_rscloud_badge, use_tidy_eval
    added 3 exports
    create_quarto_project, use_air, use_r_universe_badge
  • R
    R 4.5.0 released · 2025-04-11
  • 3.1.0
    record
    2024-11-26 · diff ↗
  • 3.0.0
    record
    2024-07-29 · diff ↗ ·
    removed 15 exports
    browse_github_pat, browse_github_token, browse_travis, git_credentials, github_token, pr_pull_upstream, pr_sync, use_appveyor, use_appveyor_badge, use_git_credentials, use_pkgdown_travis, use_tidy_ci, use_tidy_labels, use_travis, use_travis_badge
    added 1 export
    use_test_helper
  • R
    R 4.4.0 released · 2024-04-24
  • 2.2.3
    record
    2024-02-19 · diff ↗
  • 2.2.2
    record
    2023-07-06 · diff ↗
  • 2.2.1
    record
    2023-06-24 · diff ↗
  • 2.2.0
    record
    2023-06-06 · diff ↗ ·
    added 6 exports
    use_author, use_posit_cloud_badge, use_rstudio_preferences, use_standalone, use_tidy_logo, use_upkeep_issue
  • R
    R 4.3.0 released · 2023-04-21
  • 2.1.6
    record
    2022-05-25 · diff ↗ ·
    added 1 export
    use_rscloud_badge
  • R
    R 4.2.0 released · 2022-04-22
  • 2.1.5
    record
    2021-12-10 · diff ↗ ·
    added 1 export
    edit_pkgdown_config
Show 20 earlier eventsHide 20 earlier events
  • 2.1.3
    record
    2021-10-27 · diff ↗
  • 2.1.2
    record
    2021-10-25 · diff ↗
  • 2.1.0
    record
    2021-10-17 · diff ↗ ·
    removed 1 export
    use_tidy_release_test_env
    added 9 exports
    git_default_branch, git_default_branch_configure, git_default_branch_rediscover, git_default_branch_rename, use_github_file, use_import_from, use_tidy_dependencies, use_tidy_github_labels, use_tidy_upkeep_issue
  • R
    R 4.1.0 released · 2021-05-18
  • 2.0.1
    record
    2021-02-10 · diff ↗ ·
    removed 1 export
    use_tidy_pkgdown
    added 2 exports
    edit_template, use_pkgdown_github_pages
  • 2.0.0
    record
    2020-12-10 · diff ↗ ·
    removed 1 export
    use_depsy_badge
    added 20 exports
    browse_github_actions, browse_package, browse_project, create_github_token, edit_rstudio_prefs, gh_token_help, git_branch_default, issue_close_community, issue_reprex_needed, pr_forget, pr_merge_main, pr_resume, ui_unset, use_agpl_license, use_apache_license, use_cpp11, use_github_pages, use_gpl_license, use_proprietary_license, use_tidy_pkgdown
  • 1.6.3
    record
    2020-09-17 · diff ↗
  • 1.6.1
    record
    2020-04-29 · diff ↗ ·
    added 1 export
    use_github_action_check_standard
  • R
    R 4.0.0 released · 2020-04-24
  • 1.6.0
    record
    2020-04-09 · diff ↗ ·
    removed 1 export
    use_tidy_versions
    added 18 exports
    browse_circleci, create_download_url, rename_files, ui_silence, use_agpl3_license, use_appveyor_badge, use_circleci_badge, use_data_table, use_github_action, use_github_action_check_full, use_github_action_check_release, use_github_action_pr_commands, use_github_actions, use_github_actions_badge, use_latest_dependencies, use_lifecycle, use_tidy_github_actions, use_travis_badge
  • 1.5.1
    record
    2019-07-04 · diff ↗ ·
    added 4 exports
    use_circleci, use_jenkins, use_make, use_zip
  • R
    R 3.6.0 released · 2019-04-26
  • 1.5.0
    record
    2019-04-07 · diff ↗ ·
    added 61 exports
    browse_github_token, create_tidy_package, edit_r_buildignore, git_credentials, git_protocol, git_remotes, git_sitrep, git_vaccinate, github_token, local_project, pr_fetch, pr_finish, pr_init, pr_pause, pr_pull, pr_pull_upstream, pr_push, pr_sync, pr_view, proj_activate, tidy_label_colours, tidy_label_descriptions, tidy_labels_rename, ui_code, ui_code_block, ui_done, ui_field, ui_info, ui_line, ui_nope and 31 more
  • 1.4.0
    record
    2018-08-14 · diff ↗ ·
    added 10 exports
    edit_file, proj_path, proj_sitrep, use_description_defaults, use_logo, use_spell_check, use_tibble, use_tidy_thanks, write_over, write_union
  • R
    R 3.5.0 released · 2018-04-23
  • 1.3.0
    record
    2018-02-24 · diff ↗ ·
    added 8 exports
    browse_github_pat, tidy_labels, use_binder_badge, use_bioc_badge, use_git_config, use_tidy_coc, use_tidy_github, use_version
  • 1.2.0
    record
    2018-01-19 · diff ↗ ·
    added 7 exports
    use_blank_slate, use_course, use_template, use_tidy_contributing, use_tidy_issue_template, use_tidy_style, use_tidy_support
  • 1.1.0
    record
    2017-11-17 · diff ↗ ·
    added 11 exports
    browse_cran, browse_github, browse_github_issues, browse_github_pulls, browse_travis, create_from_github, use_cc0_license, use_lifecycle_badge, use_pkgdown, use_r, use_tidy_versions
  • 1.0.0
    record
    2017-10-22
  • R
    R 3.4.0 released · 2017-04-21

Package metadata

First published
2017-10-22
Total releases
26 / 9 yrs
License
MIT + file LICENSE OSI · relicensed from GPL-3 in 2.0.0
Minimum R
≥ 4.1
Download size
405 KB

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("usethis")
Bryan, J., Posit Software, PBC, Barrett, M., Teucher, A., & Wickham, H. (2026). usethis: Automate Package and Project Setup (Version 3.2.2) [Computer software]. https://doi.org/10.32614/CRAN.package.usethis

This package has no citation file, so citation() returns this entry built from DESCRIPTION.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

APA

Balamuta, J. J. (2026). R Observatory: Metrics for usethis version 3.2.2 [Data set]. HJJB, LLC. Data release v2026-10-19. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-19, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy