Scroll to navigation

XONSH(1) User Commands XONSH(1)

NAME

xonsh - Pythonish, BASHwards looking shell

DESCRIPTION

Xonsh is a Python-ish shell language and command prompt. Unlike other shells, xonsh is based on Python, with additional syntax added that makes calling subprocess commands, manipulating the environment, and dealing with the file system easy. Xonsh supports all normal Python constructs and a subset of those available in bash.

usage: xonsh [-h] [-V] [-c COMMAND] [-i] [-l] [--rc RC [RC ...]] [--no-rc]

[--no-script-cache] [--cache-everything] [-D ITEM] [--shell-type SHELL_TYPE] [--timings] [script-file] ...

xonsh

positional arguments:

If present, execute the script in script-file and exit.
Additional arguments to the script specified by script-file.

options:

Show help and exit.
Show version information and exit.
Run a single command and exit.
Force running in interactive mode.
Run as a login shell.
The xonshrc files to load, these may be either xonsh files or directories containing xonsh files
Do not load any xonsh RC files. Argument --rc will be ignored if --no-rc is set.
Do not cache scripts as they are run.
Use a cache, even for interactive commands.
Define an environment variable, in the form of -DNAME=VAL. May be used many times.
What kind of shell should be used. Possible options: b, best, d, dumb, ptk, prompt-toolkit, prompt_toolkit, rand, random, rl, readline. Warning! If set this overrides $SHELL_TYPE variable.
Prints timing information before the prompt is shown. This is useful while tracking down performance issues and investigating startup times.

FILES

The run control file is written in xonsh script and executed once at start-up.

/etc/xonshrc
System-wide run control file
~/.xonshrc
Per-user run control file

In addition to the run control file, a JSON formatted static file can be used to set runtime parameters and environment variables before the xonshrc files are executed.

$XDG_CONFIG_HOME/xonsh/config.json
Per-user static config file
March 2024 xonsh xonsh/0.15.1