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
| Key | Values | Default | What it does |
|---|---|---|---|
language | en, es | en | The 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". |
agent | a command | claude | The agent the layout runs in its agent pane. --agent and CORRAL_AGENT win over it. |
r_console | ark, r, or a command | ark | The 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_frontend | corral, jupyter | corral | Ark's front end: Corral's console, or jupyter-console. |
ark_bin | a path | the newest Ark in ~/.local/share/corral/ark | A specific Ark binary to use. |
python_console | a command | uv run --with ipython ipython --no-banner -i …/py/startup.py | The command that starts the Python console. See Consoles. |
python_lsp | ty, pylsp | ty | The editor's Python language server. Applies when the editor opens again. |
images | auto, kitty, symbols | auto | How to draw plots inside herdr: detect the terminal, Kitty images, or block characters. |
mirador_window | right, free | right | right puts each new Mirador window on the right of the screen; free leaves its size and position alone. Windows with WSL only. |
mirador_size | width x height, as fractions of the screen | 0.5x0.85 | The size of a new Mirador window, for example 0.4x0.7. Each fraction goes from 0.2 to 1. Windows with WSL only. |
table_viewer | visidata | Corral's viewer | visidata opens tables in VisiData when vd is installed. |
theme | dark-2026, herdr | herdr | Corral's own theme, or follow herdr's theme. See Themes. |
Environment variables
| Variable | What for | Default |
|---|---|---|
CORRAL_LANG | The language for one process or session: en or es. Wins over corral config language. | the setting |
CORRAL_IMAGES | How to draw plots in the terminal: auto, kitty or symbols. Wins over corral config images. | auto |
CORRAL_AGENT | The command for the agent's pane in corral layout ('' leaves a shell). Wins over corral config agent. | claude |
CORRAL_R | The command for the console in corral layout | corral _console r, which starts Ark or plain R according to r_console |
CORRAL_EDITOR | The editor for the script pane ('' leaves out the script) | fresh |
CORRAL_VIEW | Where View() opens: auto (a popup inside herdr; outside herdr, Mirador if it is running), mirador or popup | auto |
CORRAL_BROWSER | The 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_PORT | Mirador's port; if it is taken, Mirador uses another free one | 7317 |
CORRAL_TABLE_VIEWER | Another table viewer; {file} is replaced by the table's path | Corral's, with DuckDB |
CORRAL_CLIPBOARD | A command that prints the clipboard, for ctrl+b enter | wl-paste, xclip or PowerShell |
CORRAL_OPEN_PLOTS | 0 keeps Python's first plot from opening anything | 1 |
CORRAL_DIR | The folder the installer puts Corral in | ~/.local/share/corral-term |
CORRAL_URL | The package install.sh downloads | the latest published version |
CORRAL_BIN | The corral command that R and Python call | the one on the PATH |
CORRAL_REPO | Corral'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:
| Variable | What it is |
|---|---|
CORRAL | 1 in the consoles Corral starts. It is what switches Corral on in R (CORRAL=1 R does it by hand). |
CORRAL_SESSION | The id of the session a command should use. |
CORRAL_SESSION_DIR, CORRAL_PLOT_ID, CORRAL_FILE, CORRAL_TITLE | What a popup shows: the session, the plot, the table file and its title. |
CORRAL_ARK_CONNECTION | Ark's connection file, so the editor's language server can reach the console's R. |
R options
Set them in your .Rprofile.
| Option | Effect |
|---|---|
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
| Path | What is there |
|---|---|
~/.config/corral/config.json | The settings of corral config. |
~/.config/corral/palette.json | The 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. |