Skip to content

Helpers for Developing Command Line Interfaces

1,807packages dependsuggested by 101
25.3Mdownloads / year
75.6%test coverage
13/13flavors OK

Overview

About

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.

Changes in 3.6.6
  • New {.num} and {.bytes} inline styles to format numbers and bytes (@m-muecke, #644, #588, #643).

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 5.1 min · r-devel-windows-x86_64
Status changes
  • 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
Advisories

none known

Documentation

In release 3.6.6
READMEYes · 348 wordsVignettes· In the repository, left out of the releaseNEWSYes · 100% structured · mentions 3.6.6Citation fileNoWebsiteYes · pkgdown
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

25.3M
CRAN downloads in the past year
Rank #2 · ~69.4K/day · ~2.1M/mo
Daily download trend is not available in this view yet.
2.1M30 days
6.4M90 days
25.3M1 year
Compare downloads with other packages →
Also on343.1K r2u211 autocran2.5M conda_forge25.3K c2d4u

Repository

r-lib/cli ↗Organization: r-lib
728Stars
94Forks
99Open issues
18Open PRs
27Releases
1,763Commits
61Commit identities
rcli
1,763 commits · Last activity 2026-10-14 · +0.3% stars, 30d · Default branch at 3.6.6.9000, ahead of CRAN 3.6.6 (checked 2026-10-11)
Responsiveness
How these are sampled
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

2025-10-06 · 6782026-10-16 · 728
PracticesBeta

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.

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 (1)
Code of conduct
Docs source (4)
README.Rmdpkgdown

GitHub Pages site last deployed 2026-10-11 · The repository has a site deploy workflow

pkgdown site last built 2026-10-01

Coverage (1)
Coverage reporting (Codecov)
Show all practicesHide 2 practices
Reproducibility and dev environment (1)
Makefile
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-06-01
    Seen in the repository: CLAUDE.md
    Named in .Rbuildignore: CLAUDE.md
    Named in .gitignore: .claude
How this is detected·Detection ruleset v4 (updated 2026-09-27)

Dependencies

Declared dependencies
18 external dependencies (excludes base and recommended)

Installing cli adds no packages beyond those that come with R.

Depends (1)
R >= 3.4
Imports (1)
utils
LinkingTo (0)
none
Enhances (0)
none

People & History

People (5)
Author, Maintainer since 1.0.0 (2017)
Contributor · added in 3.6.2
Contributor
Contributor
Copyright holder, Funder · added in 3.6.2
Listed in earlier versions (1)
RStudio
no longer listed · 2.3.0 to 1.0.2
Releases (29)

Pick two releases to compare their code metrics.

  • R
    R 4.6.0 released · 2026-04-24
  • 3.6.6Latest
    record
    2026-04-09 · current release · diff ↗
  • 3.6.5
    record
    2025-04-23 · diff ↗
  • R
    R 4.5.0 released · 2025-04-11
  • 3.6.4
    record
    2025-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.3
    record
    2024-06-21 · diff ↗
  • R
    R 4.4.0 released · 2024-04-24
  • 3.6.2
    record
    2023-12-11 · diff ↗ ·
    added 1 export
    ansi_string
  • R
    R 4.3.0 released · 2023-04-21
  • 3.6.1
    record
    2023-03-23 · diff ↗
  • 3.6.0
    record
    2023-01-09 · diff ↗ ·
    added 4 exports
    hash_file_sha1, hash_obj_sha1, hash_raw_sha1, hash_sha1
  • 3.5.0
    record
    2022-12-20 · diff ↗ ·
    added 5 exports
    ansi_collapse, has_keypress_support, hash_file_md5, keypress, pretty_print_code
  • 3.4.1
    record
    2022-09-23 · diff ↗
  • 3.4.0
    record
    2022-09-08 · diff ↗ ·
    added 6 exports
    ansi_grep, ansi_grepl, ansi_hyperlink_types, ansi_nzchar, cli_fmt, vt_output
  • 3.3.0
    record
    2022-04-25 · diff ↗
  • R
    R 4.2.0 released · 2022-04-22
Show 23 earlier eventsHide 23 earlier events
  • 3.2.0
    record
    2022-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.1
    record
    2022-01-20 · diff ↗
  • 3.1.0
    record
    2021-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.1
    record
    2021-07-17 · diff ↗
  • 3.0.0
    record
    2021-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
  • R
    R 4.1.0 released · 2021-05-18
  • 2.5.0
    record
    2021-04-26 · diff ↗ ·
    removed 1 export
    cli_memo
    added 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
    record
    2021-04-05 · diff ↗ ·
    added 4 exports
    cli, cli_memo, spark_bar, spark_line
  • 2.3.1
    record
    2021-02-23 · diff ↗
  • 2.3.0
    record
    2021-01-31 · diff ↗ ·
    added 5 exports
    ansi_columns, ansi_strtrim, ansi_strwrap, ansi_trimws, num_ansi_colors
  • 2.2.0
    record
    2020-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
    record
    2020-10-12 · diff ↗ ·
    added 2 exports
    cli_vec, pluralize
  • R
    R 4.0.0 released · 2020-04-24
  • 2.0.2
    record
    2020-02-28 · diff ↗
  • 2.0.1
    record
    2020-01-09 · diff ↗
  • 2.0.0
    record
    2019-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
  • R
    R 3.6.0 released · 2019-04-26
  • 1.1.0
    record
    2019-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.2
    record
    2023-03-23 · diff ↗
  • 1.0.1
    record
    2018-09-25 · diff ↗ ·
    added 2 exports
    cli_sitrep, is_utf8_output
  • R
    R 3.5.0 released · 2018-04-23
  • 1.0.0
    record
    2017-11-05
  • R
    R 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")
Csárdi, G., Posit Software, PBC, Brüggemann, S., Müller, K., & Wickham, H. (2026). cli: Helpers for Developing Command Line Interfaces (Version 3.6.6) [Computer software]. https://doi.org/10.32614/CRAN.package.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.

APA

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

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.

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