Home

vscode-R is the R Extension for Visual Studio Code. The extension is mainly focused on providing user interactivity between VSCode and R sessions. To make VSCode more powerful in R scripting, it is highly recommended to also install the R language server (languageserver and vscode-r-lsp).

Visit the links on the right for more information.

This project won't be successful without contributions, especially the current and past key collaborators:

• Kun Ren (@renkun-ken)
• Andrew Craig (@andycraig)
• Thomas Brittain (@Ladvien)
• Miles McBain (@MilesMcBain)
• Manuel Hentschel (@ManuelHentschel)
• Elian H. Thiele-Evans (@ElianHugh)

Features

• Create R Integrated Terminal
• Run Source/Selected Line
• Run functions:
  • nrow (Show number of rows for selected object)
  • length (Show length for a selected object)
  • head (Show first part of a selected object)
  • thead (Show first part of a selected object (transposed))
  • names (Show names for a selected object)
• Run all commands in active terminal containing existing R session (enable config r.alwaysUseActiveTerminal)
• Extended Syntax (R, R Markdown, R Documentation)
• Create .gitignore based on R.gitignore
• Data frame viewer and Environment viewer (Preview Data frame or Preview Environment)
• Snippets
• Package development shortcuts (Load All, Test Package, Install Package, Build Package and Document)
• Bind keys to custom R commands using command runner functions (r.runCommand, r.runCommandWithEditorPath, r.runCommandWithSelectionOrWord)
• R Session Watcher to interact with R sessions
  • Watch any R session
  • Show value of session symbols on hover
  • Provide completion for session symbols
  • View() any objects including data frames and list objects
  • Show plot output on update and plot history
  • Show htmlwidgets, documentation and shiny apps in WebView

Extension Settings

• r.rterm.windows: R.exe path for windows.
• r.rterm.mac: R path for Mac OS X.
• r.rterm.linux: R path for Linux.
• r.rterm.option: R command line options.
• r.source.encoding: An optional encoding to pass to R when executing the file, i.e. source(FILE, encoding=ENCODING).
• r.source.focus: Keeping focus when running.
• r.alwaysUseActiveTerminal: Use active terminal for all commands, rather than creating a new R terminal.
• r.bracketedPaste: Use bracketed paste mode when sending code to console. Enable for Radian console.
• r.sessionWatcher: Enable R session watcher (experimental). Restart required to take effect.