Helpers for Developing Command Line Interfaces
Overview
A suite of tools to build attractive command line interfaces ('CLIs'), from semantic elements: headings, lists, alerts, paragraphs, etc. Supports custom themes via a 'CSS'-like language. It also contains a number of lower level 'CLI' elements: rules, boxes, trees, and 'Unicode' symbols with 'ASCII' alternatives. It support ANSI colors and text styles as well.
- New
{.num}and{.bytes}inline styles to format numbers and bytes (@m-muecke, #644, #588, #643).
From NEWS.md in the release
Install
Health
- OK13 OK2026-10-17
- ERROR12 OK, 1 ERROR2026-10-15
- OK13 OK2026-09-25
- ERROR12 OK, 1 ERROR2026-09-18
- OK13 OK2026-09-12
Show 28 earlier changesHide 28 earlier changes
- ERROR12 OK, 1 ERROR2026-08-20
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK13 OK2026-07-11
- ERROR12 OK, 1 ERROR2026-07-10
- OK13 OK2026-07-03
- ERROR12 OK, 1 ERROR2026-06-24
- OK13 OK2026-06-15
- ERROR12 OK, 1 ERROR2026-06-13
- OK12 OK, 1 FAILURE2026-06-08
- ERROR12 OK, 1 ERROR2026-06-06
- OK13 OK2026-05-24
- ERROR11 OK, 2 ERROR2026-05-14
- OK13 OK2026-05-11
- ERROR12 OK, 1 ERROR2026-05-10
- OK13 OK2026-05-08
- ERROR11 OK, 2 ERROR2026-05-04
- OK13 OK2026-04-30
- ERROR12 OK, 1 ERROR2026-04-28
- OK14 OK2026-04-24
- ERROR13 OK, 1 ERROR2026-04-16
- WARNING8 OK, 6 WARNING2026-03-31
- ERROR9 OK, 1 NOTE, 3 WARNING, 1 ERROR2026-03-28
- WARNING9 OK, 2 NOTE, 3 WARNING2026-03-25
- ERROR8 OK, 4 NOTE, 1 WARNING, 1 ERROR2026-03-22
- WARNING9 OK, 4 NOTE, 1 WARNING2026-03-21
- NOTE13 OK, 1 NOTE2026-03-17
- OK14 OK2026-03-10
Documentation
- Help pages
- 121 (5 internal)includes a package overview page
- Examples that run
- 98%51 run in a plain check (3 of them under a condition) · 1 never run
- Exported functions with examples
- 48%
- Documented parameters
- 96%
- Return-value docs
- 69%
- Help pages citing references
- 0%
Downloads
Repository
- PRs merged (all time)
- 90%
- Median days to close, 50 most recently updated closed issues
- 16
- 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
13 development-tooling and community-health practices detected across 6 families in the upstream repository
Checks run against github.com/r-lib/cli 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-10-11 · The repository has a site deploy workflow
pkgdown site last built 2026-10-01
Show all practicesHide 2 practices
This repository shows signs of AI coding tools.
- Claude Codefirst seen 2026-06-01Seen in the repository: CLAUDE.mdNamed in .Rbuildignore: CLAUDE.mdNamed in .gitignore: .claude
Dependencies
Installing cli adds no packages beyond those that come with R.
Show the 48 most downloaded dependentsHide the 48 most downloaded dependents
and 1,759 more dependents and 101 packages that suggest it on CRAN ↗
Code & Tests
People & History
Pick two releases to compare their code metrics.
- RR 4.6.0 released · 2026-04-24
- 3.6.6Latest
- 3.6.52025-04-23 · diff ↗
- RR 4.5.0 released · 2025-04-11
- 3.6.42025-02-13 · diff ↗ ·
added 8 exports
hash_file_xxhash, hash_file_xxhash64, hash_obj_xxhash, hash_obj_xxhash64, hash_raw_xxhash, hash_raw_xxhash64, hash_xxhash, hash_xxhash64 - 3.6.32024-06-21 · diff ↗
- RR 4.4.0 released · 2024-04-24
- 3.6.2
- RR 4.3.0 released · 2023-04-21
- 3.6.12023-03-23 · diff ↗
- 3.6.0
- 3.5.02022-12-20 · diff ↗ ·
added 5 exports
ansi_collapse, has_keypress_support, hash_file_md5, keypress, pretty_print_code - 3.4.12022-09-23 · diff ↗
- 3.4.02022-09-08 · diff ↗ ·
added 6 exports
ansi_grep, ansi_grepl, ansi_hyperlink_types, ansi_nzchar, cli_fmt, vt_output - 3.3.02022-04-25 · diff ↗
- RR 4.2.0 released · 2022-04-22
Show 23 earlier eventsHide 23 earlier events
- 3.2.02022-02-14 · diff ↗ ·
added 11 exports
hash_file_sha256, hash_obj_animal, hash_obj_emoji, hash_obj_md5, hash_obj_sha256, hash_raw_animal, hash_raw_emoji, hash_raw_md5, hash_raw_sha256, hash_sha256, ruler - 3.1.12022-01-20 · diff ↗
- 3.1.02021-10-27 · diff ↗ ·
added 34 exports
ansi_html, ansi_html_style, ansi_palette_show, ansi_palettes, ansi_simplify, bg_br_black, bg_br_blue, bg_br_cyan, bg_br_green, bg_br_magenta, bg_br_red, bg_br_white, bg_br_yellow, cli_bullets_raw, code_highlight, code_theme_list, col_br_black, col_br_blue, col_br_cyan, col_br_green, col_br_magenta, col_br_red, col_br_white, col_br_yellow, diff_chr, diff_str, format_bullets_raw, hash_animal, hash_emoji, hash_md5 and 4 more - 3.0.12021-07-17 · diff ↗
- 3.0.02021-06-30 · diff ↗ ·
added 42 exports
__cli_update_due, ccli_tick_reset, cli_abort, cli_inform, cli_progress_along, cli_progress_bar, cli_progress_builtin_handlers, cli_progress_cleanup, cli_progress_demo, cli_progress_done, cli_progress_message, cli_progress_num, cli_progress_output, cli_progress_step, cli_progress_styles, cli_progress_update, cli_tick_reset, cli_warn, format_inline, pb_bar, pb_current, pb_current_bytes, pb_elapsed, pb_elapsed_clock, pb_elapsed_raw, pb_eta, pb_eta_raw, pb_eta_str, pb_extra, pb_id and 12 more - RR 4.1.0 released · 2021-05-18
- 2.5.02021-04-26 · diff ↗ ·
removed 1 export
cli_memoadded 20 exports
ansi_chartr, ansi_tolower, ansi_toupper, bg_none, cli_bullets, col_none, format_error, format_message, format_warning, style_no_bg_color, style_no_blurred, style_no_bold, style_no_color, style_no_dim, style_no_hidden, style_no_inverse, style_no_italic, style_no_strikethrough, style_no_underline, test_that_cli - 2.4.0
- 2.3.12021-02-23 · diff ↗
- 2.3.02021-01-31 · diff ↗ ·
added 5 exports
ansi_columns, ansi_strtrim, ansi_strwrap, ansi_trimws, num_ansi_colors - 2.2.02020-11-20 · diff ↗ ·
added 10 exports
ansi_align, ansi_has_any, ansi_has_hyperlink_support, ansi_nchar, ansi_regex, ansi_strip, ansi_strsplit, ansi_substr, ansi_substring, style_hyperlink - 2.1.0
- RR 4.0.0 released · 2020-04-24
- 2.0.22020-02-28 · diff ↗
- 2.0.12020-01-09 · diff ↗
- 2.0.02019-12-09 · diff ↗ ·
added 38 exports
builtin_theme, cli_alert, cli_alert_danger, cli_alert_info, cli_alert_success, cli_alert_warning, cli_blockquote, cli_code, cli_div, cli_dl, cli_end, cli_format, cli_format_method, cli_h1, cli_h2, cli_h3, cli_li, cli_list_themes, cli_ol, cli_output_connection, cli_par, cli_process_done, cli_process_failed, cli_process_start, cli_rule, cli_status, cli_status_clear, cli_status_update, cli_text, cli_ul and 8 more - RR 3.6.0 released · 2019-04-26
- 1.1.02019-03-19 · diff ↗ ·
added 35 exports
ansi_hide_cursor, ansi_show_cursor, ansi_with_hidden_cursor, bg_black, bg_blue, bg_cyan, bg_green, bg_magenta, bg_red, bg_white, bg_yellow, col_black, col_blue, col_cyan, col_green, col_grey, col_magenta, col_red, col_silver, col_white, col_yellow, combine_ansi_styles, is_ansi_tty, is_dynamic_tty, make_ansi_style, make_spinner, style_blurred, style_bold, style_dim, style_hidden and 5 more - 1.0.22023-03-23 · diff ↗
- 1.0.1
- RR 3.5.0 released · 2018-04-23
- 1.0.02017-11-05
- RR 3.4.0 released · 2017-04-21
Package metadata
- First published
- 2017-11-05
- Total releases
- 29 / 9 yrs
- License
- MIT + file LICENSE OSI
- Minimum R
- ≥ 3.4
- Download size
- 629 KB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("cli")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-18, which the citation names so these numbers can be found later. More on citing and the projects behind them.