From Gentoo Wiki
Jump to:navigation Jump to:search
This article is a stub. Please help out by expanding it - how to get started.

Xonsh combines a traditional shell with the full power of Python, allowing POSIX shell style constructs used along with standard Python code.

Xonsh is multi platform, and is designed for interactive use, but can also be useful for scripting. Xonsh is very customizable, and there is a plugin system called xontribs.


Xonsh is not currently present in the Gentoo ebuild repository, though it may be installed by following instructions from the project's website. Care must however be taken to keep Xonsh up to date, independently of Portage software.


To set Xonsh as the default shell with chsh, it will have to be added to /etc/shells. See https://xon.sh/customization.html#set-xonsh-as-my-default-shell for how to do this.


The main Xonsh user configuration file is either ~/.xonshrc or, ~/.config/xonsh/rc.xsh - choose one upon first use. There can also be a system-wide config file at /etc/xonshrc.

If a there is a ~/.config/xonsh/rc.d directory, any *.xsh files in it will get "sourced" on startup.

See also

  • Shell — command-line interpreter that offers a text-based interface to users.