Automate Package and Project Setup
Overview
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.
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 theAGENTS.mdcreated byuse_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. Useinstall_dependencies = FALSEto 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 specificbranch) andpr_fetch()(without a specificnumber) 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 starterREADME.qmdwith Quarto-flavored YAML frontmatter, analogous touse_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()anduse_roxygen_md()now record the roxygen2 version in theConfig/roxygen2/versionfield (instead ofRoxygenNote) 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 viaaskpass::askpass(), and activates it in the current session viaSys.setenv()(#2201, @gadenbuie).use_course(),use_zip(), anduse_github_action()no longer emit download or pagination progress when theusethis.quietoption isTRUE.use_pipe()is deprecated (@math-mcshane, #2124).use_release_issue()points first-time submitters todevtools::check_doc_fields()to verify that exported functions document their return values (#2241).use_tidy_upkeep_issue()no longer includes the deprecateduse_tidy_style()in the upkeep checklist (#2197, @edgararuiz).
From NEWS.md in the release
Install
Health
- OK13 OK2026-08-04
- NOTE12 OK, 1 NOTE2026-08-01
- OK13 OK2026-06-09
- ERROR12 OK, 1 ERROR2026-06-07
- OK14 OK2026-03-10
Documentation
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
Repository
- 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
Forks over time
Releases over time
Issues over time
PRs over time
Commits over time
Commit identities over time
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.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
GitHub Pages site last deployed 2026-09-22 · The repository has a site deploy workflow
pkgdown site last built 2026-09-11
Show all practicesHide 3 practices
This repository shows signs of AI coding tools.
- Claude Codefirst seen 2026-02-03Seen in the repository: .claudeNamed in .Rbuildignore: .claude
Dependencies
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.
Show the 48 most downloaded dependentsHide the 48 most downloaded dependents
and 38 more dependents and 210 packages that suggest it on CRAN ↗
Code & Tests
People & History
Previously maintained by Hadley Wickham (1.0.0 to 1.4.0).
Pick two releases to compare their code metrics.
- 3.2.2Latest2026-09-10 · current release · diff ↗ ·
added 4 exports
learn_tidy_skill, use_env_var, use_readme_qmd, use_tidy_agents - RR 4.6.0 released · 2026-04-24
- 3.2.12025-09-06 · diff ↗
- 3.2.02025-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_evaladded 3 exports
create_quarto_project, use_air, use_r_universe_badge - RR 4.5.0 released · 2025-04-11
- 3.1.02024-11-26 · diff ↗
- 3.0.02024-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_badgeadded 1 export
use_test_helper - RR 4.4.0 released · 2024-04-24
- 2.2.32024-02-19 · diff ↗
- 2.2.22023-07-06 · diff ↗
- 2.2.12023-06-24 · diff ↗
- 2.2.02023-06-06 · diff ↗ ·
added 6 exports
use_author, use_posit_cloud_badge, use_rstudio_preferences, use_standalone, use_tidy_logo, use_upkeep_issue - RR 4.3.0 released · 2023-04-21
- 2.1.6
- RR 4.2.0 released · 2022-04-22
- 2.1.5
Show 20 earlier eventsHide 20 earlier events
- 2.1.32021-10-27 · diff ↗
- 2.1.22021-10-25 · diff ↗
- 2.1.02021-10-17 · diff ↗ ·
removed 1 export
use_tidy_release_test_envadded 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 - RR 4.1.0 released · 2021-05-18
- 2.0.12021-02-10 · diff ↗ ·
removed 1 export
use_tidy_pkgdownadded 2 exports
edit_template, use_pkgdown_github_pages - 2.0.02020-12-10 · diff ↗ ·
removed 1 export
use_depsy_badgeadded 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.32020-09-17 · diff ↗
- 1.6.1
- RR 4.0.0 released · 2020-04-24
- 1.6.02020-04-09 · diff ↗ ·
removed 1 export
use_tidy_versionsadded 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
- RR 3.6.0 released · 2019-04-26
- 1.5.02019-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.02018-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 - RR 3.5.0 released · 2018-04-23
- 1.3.02018-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.02018-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.02017-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.02017-10-22
- RR 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")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.
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.