History

Benjamin Levy 012b97fafb tweak(eshell): bind C-l to clear-scrollback Make C-l have the same behavior as the clear alias by clearing the scrollback.		2021-11-21 19:05:18 +01:00
..
autoload	feat(eshell): add vertico completion for eshell history (#5614 )	2021-10-18 01:35:44 +02:00
config.el	tweak(eshell): bind C-l to clear-scrollback	2021-11-21 19:05:18 +01:00
packages.el	bump: :app :checkers :config :emacs :term :tools :ui	2021-09-15 17:47:17 +02:00
README.org	Migrate term to variable and add README note	2021-02-23 19:38:31 +00:00

README.org

term/eshell

Description
Prerequisites
Features
Configuration
- TERM name
Troubleshooting

Description

This module provides additional features for the built-in Emacs Shell

The Emacs Shell or eshell is a shell-like command interpreter implemented in Emacs Lisp. It is an alternative to traditional shells such as bash, zsh, fish, etc. that is built into Emacs and entirely cross-platform.

Maintainers

This module has no dedicated maintainers.

Module Flags

This module provides no flags, but does gain auto-completion if :completion company is enabled.

Plugins

eshell-up
eshell-z
esh-help
shrink-path
eshell-did-you-mean
:completion company
- fish-completion
- bash-completion

Hacks

Even with fish-completion-fallback-on-bash-p non-nil, fish must be installed for bash completion to work. Workaround in config.el.
eshell-did-you-mean does not work on first invocation, so we manually invoke it once.

Prerequisites

fish shell for completions, falling back to bash shell if fish is not found. If neither shell is found, completions may not be available.

Features

Command completion with Company
fish-style prompt with Git integration
z-like directory jumping
Command-not-found recommendations

Configuration

TERM name

By default, eshell sets the $TERM variable to "xterm-256color", which helps with rendering various colours. As eshell is not a terminal emulator, these will not always work 100%. Modifying eshell-term-name to your liking may help.