Configuration

Corral's settings live in ~/.config/corral/config.json, and corral config reads and changes them. A few environment variables and R options cover the rest.

corral config

$ corral config
$ corral config r_console
$ corral config r_console r

Without arguments it prints every setting as JSON. With a key, it prints that value; with a key and a value, it sets it. The keys with a fixed list of values refuse anything else and tell you what they take.

Language

Corral speaks English. To see its windows, messages and Mirador in Spanish:

$ corral config language es
$ corral config language en

Or pick "Corral: idioma: español" or "Corral: language: English" in the palette (ctrl+b space). Open windows and consoles switch within a couple of seconds; the script editor, the next time it opens. The editor (Fresh) follows Corral's language whatever your system's is; to give it another one, add --locale to CORRAL_EDITOR, for example fresh --locale fr. Commands, options and settings keep their English names in both languages.

Keys

KeyValuesDefaultWhat it does
languageen, esenThe language of Corral's windows, messages and Mirador: English or Spanish. It switches at once; the script editor when you open it again. Commands and options stay in English. The palette (ctrl+b space) has it too: "Corral: language: English" and "Corral: idioma: español".
agenta commandclaudeThe agent the layout runs in its agent pane. --agent and CORRAL_AGENT win over it.
r_consoleark, r, or a commandarkThe R console: Ark, plain R (R --quiet --no-save), or your own command. Without Ark installed, it is plain R. Applies to the consoles you open afterwards.
ark_frontendcorral, jupytercorralArk's front end: Corral's console, or jupyter-console.
ark_bina paththe newest Ark in ~/.local/share/corral/arkA specific Ark binary to use.
python_consolea commanduv run --with ipython ipython --no-banner -i …/py/startup.pyThe command that starts the Python console. See Consoles.
python_lspty, pylsptyThe editor's Python language server. Applies when the editor opens again.
imagesauto, kitty, symbolsautoHow to draw plots inside herdr: detect the terminal, Kitty images, or block characters.
mirador_windowright, freerightright puts each new Mirador window on the right of the screen; free leaves its size and position alone. Windows with WSL only.
mirador_sizewidth x height, as fractions of the screen0.5x0.85The size of a new Mirador window, for example 0.4x0.7. Each fraction goes from 0.2 to 1. Windows with WSL only.
table_viewervisidataCorral's viewervisidata opens tables in VisiData when vd is installed.
themedark-2026, herdrherdrCorral's own theme, or follow herdr's theme. See Themes.

Environment variables

VariableWhat forDefault
CORRAL_LANGThe language for one process or session: en or es. Wins over corral config language.the setting
CORRAL_IMAGESHow to draw plots in the terminal: auto, kitty or symbols. Wins over corral config images.auto
CORRAL_AGENTThe command for the agent's pane in corral layout ('' leaves a shell). Wins over corral config agent.claude
CORRAL_RThe command for the console in corral layoutcorral _console r, which starts Ark or plain R according to r_console
CORRAL_EDITORThe editor for the script pane ('' leaves out the script)fresh
CORRAL_VIEWWhere View() opens: auto (a popup inside herdr; outside herdr, Mirador if it is running), mirador or popupauto
CORRAL_BROWSERThe browser for Mirador and help pages: firefox, edge, chrome, print (only prints the URL), or a command with {url}On WSL, Firefox, or Edge or Chrome without it; on Linux, xdg-open
CORRAL_MIRADOR_PORTMirador's port; if it is taken, Mirador uses another free one7317
CORRAL_TABLE_VIEWERAnother table viewer; {file} is replaced by the table's pathCorral's, with DuckDB
CORRAL_CLIPBOARDA command that prints the clipboard, for ctrl+b enterwl-paste, xclip or PowerShell
CORRAL_OPEN_PLOTS0 keeps Python's first plot from opening anything1
CORRAL_DIRThe folder the installer puts Corral in~/.local/share/corral-term
CORRAL_URLThe package install.sh downloadsthe latest published version
CORRAL_BINThe corral command that R and Python callthe one on the PATH
CORRAL_REPOCorral's folder, for the files the binary reads (the plugin, the R and Python sides)the folder the binary sits in

Set by Corral

Corral sets these itself, for its own processes. You rarely need them, but you may see them:

VariableWhat it is
CORRAL1 in the consoles Corral starts. It is what switches Corral on in R (CORRAL=1 R does it by hand).
CORRAL_SESSIONThe id of the session a command should use.
CORRAL_SESSION_DIR, CORRAL_PLOT_ID, CORRAL_FILE, CORRAL_TITLEWhat a popup shows: the session, the plot, the table file and its title.
CORRAL_ARK_CONNECTIONArk's connection file, so the editor's language server can reach the console's R.

R options

Set them in your .Rprofile.

OptionEffect
options(corral.viewer = "mirador")The first plot opens Mirador inside herdr too. "httpgd" opens httpgd's own viewer.
options(corral.open_plots = FALSE)The first plot doesn't notify or open anything.
options(corral.httpgd = FALSE)Keeps R's default graphics device.
options(corral.vars = FALSE)Doesn't publish the variables.
options(corral.always = TRUE)Switches Corral on in every R session you open. It goes before Corral's line in .Rprofile.
options(corral.bin = "/path/to/corral")The corral command R calls, instead of the one on the PATH.

Where Corral keeps things

PathWhat is there
~/.config/corral/config.jsonThe settings of corral config.
~/.config/corral/palette.jsonThe palette in use, which the viewers, VisiData and Mirador read.
~/.local/state/corral/Sessions, the R console's history (historial-r.jsonl), Mirador's address and token (mirador.json), and the logs ark.log and mirador.log.
~/.local/share/corral/Ark and the programs the installer downloaded.
~/.local/share/corral-term/Corral itself.