Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
A

arf

> 编程语言
Open source

Alternative R Frontend — a modern R console written in Rust

339 stars0 likes1 views
WebsiteGitHub

About

Alternative R Frontend — a modern R console written in Rust

arf is a cross-platform R console written in Rust.

[!WARNING] arf is under active development. The configuration file format and history file format are not yet stable and may change without notice in future versions.

Features

  • Single binary with no runtime dependencies
  • Cross-platform: Linux, macOS, and Windows
  • R version selection via rig (switch within a session, or experimental per-directory auto-switching)
  • Vi and Emacs editing modes
  • Multiline editing with proper indentation
  • Auto-matching brackets and quotes (with smart skip-over)
  • Tab completion for R objects, functions, and file paths inside strings
  • fzf-style history search with Ctrl+R; import from radian or .Rhistory
  • Customizable keyboard shortcuts (Alt+- → )
  • Command status indicator (shows error symbol when previous command failed)
  • Fuzzy help browser with :help or :h — search across all installed packages
  • Tree-sitter based syntax highlighting with customizable colors
  • Reprex mode with optional formatting via Air 0.9.0+ or Arity 0.18.0+
  • Shell mode (:shell to enter, :r to return)
  • Configurable prompts and colors with placeholders ({version}, {cwd}, {status})
  • SQLite-backed persistent history with import/export support
  • IPC server for AI agent and CI integration
  • Headless mode for non-interactive environments (CI, background jobs)

Installation

Pre-built Binaries

Pre-built binaries are available from GitHub Releases.

Shell Installer (Linux/macOS)

bash
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/eitsupi/arf/releases/latest/download/arf-console-installer.sh | sh

winget (Windows)

bash
winget install --id eitsupi.arf

Scoop (Windows)

bash
scoop bucket add r-bucket https://github.com/cderv/r-bucket.git
scoop install r-bucket/arf

cargo-binstall

bash
cargo binstall --git https://github.com/eitsupi/arf arf-console

Manual Download

Download the archive for your platform from GitHub Releases and extract the binary to a directory in your PATH.

Third-Party Packages

Homebrew (macOS/Linux)

bash
brew install arf

AUR (Arch Linux/Manjaro)

bash
yay -S arf-bin
# or use paru
paru -S arf-bin

Build from Source

bash
cargo install --git https://github.com/eitsupi/arf.git

[!NOTE] For Windows: A fix for VT input handling (bracketed paste, etc.) is pending in an upstream dependency (crossterm#1030).

So installing from crates.io (cargo install arf-console) is not recommended.

Quick Start

bash
# Launch arf
arf

# Use a specific R version (requires rig)
arf --with-r-version 4.4

# Enable reprex mode for reproducible examples
arf --reprex=on

Interactive Help

Press :h or :help to open the fuzzy help browser:

─ Help Search [12345 topics] ─────────────────────────
  Filter: mutate_

 > dplyr::mutate           Create, modify, and delete columns
   dplyr::mutate_all       Mutate multiple columns
   dplyr::mutate_at        Mutate multiple columns
   dplyr::mutate_if        Mutate multiple columns
─────────────────────────────────────────────────────
  ↑↓ navigate  Tab/Enter select  Esc exit

Meta Commands

arf extends R with : prefixed meta commands:

Command Description
:help, :h Open interactive help browser
:info, :session Show session information (version, config path, etc.)
:shell Enter shell mode
:r Return to R mode
:system Execute a single shell command inline
:reprex Set reprex mode (format requires the configured formatter)
:switch Restart with different R version (requires rig)
:restart Restart R session
:cd [path] Change working directory (no args → home)
:pushd Push current directory to stack and change to path
:popd Pop directory from stack and change to it
:history browse Browse and manage command history
:history clear Clear command history (supports r, shell, all targets)
:history schema Display history database schema and R examples
:commands, :cmds Show available commands
:quit, :exit Exit arf

[!NOTE] :switch keeps the R-related environment variables you set before starting arf, apart from R_HOME and LD_LIBRARY_PATH, which are always removed. :restart leaves the environment untouched. See Switching and Restarting for details.

[!NOTE] Experimental: Enable the experimental.shell_semicolon_shortcut option to switch to shell mode by pressing ; at an empty prompt — no :shell or Enter required (similar to Julia REPL behavior).

Configuration

arf uses a TOML configuration file located at:

  • Linux: ~/.config/arf/arf.toml
  • macOS: ~/Library/Application Support/arf/arf.toml
  • Windows: %APPDATA%\arf\arf.toml

Generate a default configuration with:

bash
arf config init

Example Configuration

…

See the full Configuration Guide for all options.

Headless Mode & IPC

[!NOTE] This feature is experimental and may change in future versions.

Run R without a terminal and interact via IPC — useful for AI agents, CI, and editor extensions. Unlike MCP-based solutions that require R package installation and an MCP client, arf provides a single binary with a simple CLI for programmatic R access:

bash
# Terminal 1: start headless R with `+` allowlisted for silent eval
arf headless --ipc-eval-allow-function '+'

# Terminal 2: silently evaluate R code (not shown, so `+` was allowlisted at startup)
arf ipc eval '1 + 1'

# Or show the code where a person can see it; visible eval needs no allowlist
arf ipc eval --visible '1 + 1'

# Get session info as JSON
arf ipc session | jq '.r.version'

# Shut down when done
arf ipc shutdown

See the full IPC & Headless Mode Guide for details.

Experimental Features

Features in this section are under development and may change or be removed in future versions. Configure them under the [experimental] table and its subtables (e.g. [experimental.prompt_spinner]).

R Source Overrides

Select an R version per directory or project with experimental.r_source_overrides. Disabled by default. It can read a .r-version file or rv's rproject.toml; only the current directory is searched, and only R versions rig has already installed can be selected.

toml
[experimental]
r_source_overrides = [
  { type = "version-file", file = ".r-version" },
  { type = "toml-key", file = "rproject.toml", key = "project.r_version" },
]

See R Source Overrides configuration for provider options and resolution details.

An external tool can ask arf which R it would use, without starting R, with the experimental arf r resolve command.

Spinner

Displays an animated spinner at the start of the line while R is evaluating code. Disabled by default.

To enable, set the frames option:

toml
[experimental.prompt_spinner]
frames = "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏"  # Braille dots
color = "Cyan"              # Spinner color (default: Cyan)

See Spinner configuration for all options and frame style examples.

Auto-completion while typing

Show the completion menu automatically after typing a minimum number of characters, without requiring Tab.

toml
[experimental]
completion_min_chars = 3  # Show completions after 3 characters

When not set, completion requires pressing Tab (the default behavior). This is similar to radian's complete_while_typing feature.

Fuzzy R completion

Use fuzzy matching for R code completions. When enabled, typing sf::geo can match sf::st_geometry and library(dpl can match dplyr. Disabled by default.

toml
[experimental.r_completion]
fuzzy = true

Both :: (exported names) and ::: (internal names) are supported. Package exports are cached per-package with a 5-minute TTL for performance.

See Fuzzy R Completion configuration for the package_functions option and other details.

History forget

Automatically remove commands that produced errors from history. Similar to fish's sponge plugin.

toml
[experimental.history_forget]
enabled = true
delay = 2          # Keep last N failed commands for quick retry
on_exit_only = false  # Purge on each prompt (false) or only on exit (true)

See History forget configuration for all options.

History export/import

[!CAUTION] These features are experimental and have not been thoroughly tested. The format and behavior may change in future versions.

Export

Export both R and shell history to a unified SQLite file for backup or transfer:

bash
# Export to a unified file
arf history export --file ~/arf_backup.db

# Export with custom table names
arf history export --file ~/arf_backup.db --r-table my_r --shell-table my_shell

Options:

Option Description
--file Path to output SQLite file (required)
--r-table Table name for R history (default: r)
--shell-table Table name for shell history (default: shell)

Import

Import command history from radian, R's native .Rhistory, or another arf database:

…

Options:

Option Description
--from Source format: radian, r, or arf (required)
--file Path to source file (required for arf, defaults to standard locations for others)
--hostname Custom hostname to mark imported entries
--dry-run Preview without importing
--import-duplicates Import duplicate entries instead of skipping them
--unified Force unified file mode (import both R and shell from table names)
--r-table Table name for R history in unified file (default: r)
--shell-table Table name for shell history in unified file (default: shell)

Supported sources:

Source Description Timestamps Multiline Mode routing
radian ~/.radian_history Preserved Preserved By # mode:
r .Rhistory or R_HISTFILE - - → r.db
arf SQLite database (--file required) Preserved Preserved By filename or --unified

Mode routing for arf format:

  • Files named r.db or shell.db: Single-database import (by filename)
  • Other filenames or --unified flag: Unified import (by table names, imports both R and shell)

Notes:

  • By default, duplicate entries are skipped during import (matched by command text and timestamp). Use --import-duplicates to import all entries regardless.
  • Self-import is detected and rejected when importing from an arf database to the same target file.
  • Important: Exit arf before exporting to ensure the source databases are in a consistent state. The export itself uses atomic writes to prevent incomplete output files, but reading while arf is writing may capture inconsistent data.

Known Issues

Error detection uses options(error = ...)

arf uses R's options(error = ...) to detect errors from packages like dplyr/rlang that output error messages to stdout instead of stderr. This is necessary for accurate error tracking in command history and the status indicator.

Limitations:

  • If you set a custom error handler via options(error = ...), arf will chain to your handler, but arf's handler takes precedence. Your hand

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Rustconsolerrustterminal

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 18, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言