rlwrap(1) General Commands Manual rlwrap(1) (NAME) rlwrap - (SYNOPSIS) rlwrap [rlwrap-options] command ... (DESCRIPTION) rlwrap command readline . rlwrap ( ) ( ) command rlwrap command . (re-directing) (piping) / command command ( -U) . ( ) (prompts) . ( ) ... (OPTIONS) -a[password_prompt], --always-readline[=password_prompt] << >> ( ) command. rlwrap << >> command . : rlwrap ( ) command . (-aPassword:) (--always-readline=Password:) . -N (--no-children) command . -A[!], --ansi-colour-aware[=!] CSI bracketed-paste rlwrap . ( ) rlwrap . '!' rlwrap . (-A!) (--ansi-colour-aware=!) . -b, --break-chars list_of_characters . -f ( !) <<>> . : (){}[],'+-=&^%$#@";|\ -c / . () . (Whitespace) "precisely:" . : -b $'precisely:\t' . rlwrap (newlines) . -c, --complete-filenames ( -i). OS X FreeBSD Solaris rlwrap command . -C, --command-name command_name|N command_name command $if command_name $INPUTRC. N > 0 : N command_name ( ). -D, --history-no-dupes n . n = 0 n = 1 () n = 2 rlwrap ( ) . -D 2 operate-and-get-next ! -e, --extra-char-after-completion char rlwrap . '' ( ) . -E, --always-echo rlwrap '***' ECHO . rlwrap ECHO (-aPassword: ). -f, --file file file ( --break-chars ) . RLWRAP_HOME$ /usr/share/rlwrap/completions . -f . rlwrap . -g, --forget-matching regexp ( ) POSIX 1003.2 regexp . -g '^[[:blank:]]' ( -g '^ ') . . perl '\d' '[[:digit:]]' . regex (7) . -h, --help . -H, --history-filename file file ( 0 <= histsize-- ). -i, --case-insensitive ( ). -f . -I, --pass-sigint-as-sigterm TERM command INT ( CTRL-C ). -l, --logfile file command ( ) file ( file ). -m[newline_substitute], --multi-line[=newline_substitute] << >> ( " \ " [--]). command . RLWRAP_EDITOR$ () rlwrap_call_editor ( CTRL-^) . (-m';;') (--multi-line=';;') . -M, --multi-line-ext .ext .ext ( ). -n, --no-warnings . -N, --no-children rlwrap --always- readline ENTER . rlwrap -N command . -o, --one-shot EOF command . -O, --only-cook regexp (cook) regexp '!' (<< >>). -p[colour], --prompt-colour[=colour] black, red, green, yellow, blue, cyan, purple (=magenta) white ANSI $'\033[1;33m' 'ESC[38;5;209m'. (Yellow YELLOW) . () << >> (ASCII 0x01 0x02) . --ansi-colour-aware . 'ANSI color' . (-p'Red') (--prompt-colour='Red') . -P, --pre-given text rlwrap text ( --always-readline ). -q, --quote-characters list_of_characters . (: -q "\"'", -q "\"" ). -r, --remember . -R, --renice rlwrap (nicer) command ( nice (1)). command rlwrap command . -s, --histsize N N (: 300). -N ( -0) N . -S, --substitute-prompt prompt command. command . -t, --set-terminal-name name TERM command name. rlwrap -t dumb . -U, --mirror-arguments ( ) command ps (1) rlwrap. rlwrap . --polling ( ) . -v, --version rlwrap. -w, --wait-before-prompt timeout command rlwrap timeout . ( ) . <<>> . rlwrap (<< >>). . : 40 . -W, --polling timeout timeout -w (--wait-before-prompt) ( 40 ). ISIG stdin . CTRL-C command rlwrap . -X, --skip_setctty command: command rlwrap . (: SIGHUP ). -z, --filter filter filter rlwrap. python perl rlwrap . . rlwrap perl python ( RlwrapFilter(3pm) ). /usr/share/rlwrap/filters . rlwrap -z listing rlwrap -z filter filter . filter : rlwrap -z 'filter args' command ... rlwrap -z 'pipeline filter1 ... : filter2 ... : ...' command ... rlwrap . sed grep rlwrap . makefilter : rlwrap -z 'makefilter egrep -i --color "error|$"' command "error" ( "Error") command rlwrap -z 'makefilter --message-type history sed -e s"/whisky/lemonade/"' command . pipeline . (EXAMPLES) nc (netcat) rlwrap nc smbclient ( ) ( less) smbclient . rlwrap -aPassword: -N smbclient //PEANUT/C sensitive_app ps ( sensitive_app ) : rlwrap -g '^ ' -U sensitive_app --password MySeCrEt gauche ( Scheme) ( scm.) ( (print 'q) ) rlwrap -pBlue -m -M .scm -q'"' gosh sqlite3 pipeto SQL grep / less ( ) SQL 'sql_words' rlwrap -a -z pipeto -i -f sql_words sqlite3 contacts.db rlwrap '' (one-shot) read order=$(rlwrap -pYellow -S 'Your pizza? ' -H past_orders -P Margherita -o cat) (DIRECT MODE AND READLINE MODE) <<>> (cooked) <<>> (raw) . ENTER . backspace . rlwrap command rlwrap <<>> (pty) pty . rlwrap command (<< >>). rlwrap (<< >>) command . <<>> <<>> ( ). . rlwrap . . rlwrap << >>. ENTER rlwrap --always-readline ( -n ). (PATIENT, IMPATIENT AND CONFIDENT MODE) command << >> (chunks) ( ) . (<< >>) (<<>>) . rlwrap () . 40 -w . rlwrap <<>> . <<>> (impatient) . ( ) rlwrap -w ( -w -40) << >> . Rlwrap . << >> --only-cook='!' ( ). ( ) . <<>> . -w . (COOKING PROMPTS) rlwrap : (-z) (-S) (-p) . <<>> ( <<>>). (SPECIAL KEYS AND BINDABLE COMMANDS) Control + O . readline rlwrap-accept-line-and-forget . Control + ^ ( RLWRAP_EDITOR ) ( -m ). readline rlwrap-call-editor . ( ) ( ) readline rlwrap-direct-keypress . ( ) command rlwrap . ( ) readline rlwrap-direct-prefix . () << >> . ( ) readline rlwrap-hotkey . ( RlwrapFilter(3pm)) ( ) ( ). . ( ) rlwrap-hotkey-without-history rlwrap-hotkey ( ) . . ( ) operate-and-get-next . readline (CTRL + O) rlwrap ~/.inputrc . -D 2 (--history-no-dupes 2) ( ). . ( ) ( ) ~/.inputrc : "\M-\C-m": rlwrap-accept-line-and-forget # ESC-ENTER to accept but keep out of history "\C-x": rlwrap-call-editor # CTRL-x e to edit (multi-line) input in editor of your choice $if erl # (only) for the Erlang shell: "\C-g": rlwrap-direct-keypress # pass CTRL-g directly to enter 'user switch' command $endif "\C-t": rlwrap-direct-prefix # make it possible to define direct keypresses that start with CTRL-t ... "\C-tx": rlwrap-direct-keypress # ... in that case: pass CTRL-t + x directly. "\C-y": rlwrap-hotkey-without-history # CTRL-y to filter input line (and e.g. insert X selection) readline(3). (: CTRL+S rlwrap ). (ENVIRONMENT) RLWRAP_HOME: . RLWRAP_EDITOR ( EDITOR VISUAL): ( rlwrap-edit-history) . : export RLWRAP_EDITOR="vi +%L" export RLWRAP_EDITOR="vim '+call cursor(%L,%C)'" export RLWRAP_EDITOR="emacs +%L:%C %F" L% C% rlwrap F% () . F% () RLWRAP_EDITOR$ . RLWRAP_FILTERDIR: (rlwrap -z filter rlwrap -z dir/filter) rlwrap $RLWRAP_FILTERDIR ( /usr/share/rlwrap/filters ). (SIGNALS) command : HUP INT QUIT USR1 USR2 TERM ( command) WINCH. TSTP ( CTRL-Z ) rlwrap ( 'fg') . / << >> rlwrap . ( ) CTRL-C ( rlwrap ). command ( emacs CTRL-C CTRL-G ) rlwrap ( rlwrap --polling ). command (kill) rlwrap . rlwrap . (REDIRECTION) ( emacs) rlwrap command . stdout ( stderr) rlwrap command dev/tty/ ( ) command rlwrap . rlwrap command command . (EXIT STATUS) rlwrap command . rlwrap (crash). (FILES) rlwrap RLWRAP_HOME$ (dotfiles) . rlwrap . $RLWRAP_HOME/command_history, ~/.command_history command ( command --command-name ( -C) ). $RLWRAP_HOME/command_completions, ~/.command_completions command. rlwrap -l logfile -f logfile -r . /usr/share/rlwrap/completions/command command. . $INPUTRC, ~/.inputrc readline ( readline (3) ). rlwrap application name command ( -C ) . ~/.inputrc : $if coqtop set show-all-if-ambiguous On $endif rlwrap coqtop . (LIMITATIONS) rlwrap ( ) << >> . rlwrap command . GNU Readline command . << >>: rlwrap command (race conditions) command rlwrap command . ( ) . rlwrap ( -A -t dissect_prompt ). -A (--ansi-colour- aware) . --set- term-name dumb . (VERSION) 0.48 rlwrap . (AUTHORS) GNU Readline ( Brian Fox Chet Ramey) pty ( Geoff C. Wing) rxvt libredblack Damian Ivereigh . Hans Lub (hanslub42@gmail.com) . (SEE ALSO) readline(3), RlwrapFilter(3pm) November 7, 2025 rlwrap(1)