`clear`

After a long session of dir, log or help, the screen can become hard to read. clear removes only the visible terminal output; cls is the same action. Neither command deletes a file or changes the working directory.

SystemVersion 1.1.5Stable

lil-terminal

pwd/sandboxdir 1 . -Fconfig/ data/ logs/ src/ tmp/clsPreview only — the visitor’s terminal is not changed. Screen cleared.clearPreview only — the visitor’s terminal is not changed. Screen cleared.clear -hPreview only — the visitor’s terminal is not changed. Screen cleared. Browser command history cleared.

Overview

Use clear -h if you also want to forget the commands remembered by this browser. clear -H goes further: it deletes the saved transcript from history -l as well. Both options need the history module; otherwise they return an error.

Screen, history and transcript are separate

Clearing the transcript does not switch off persistent recording. If history -l on was enabled, use history -l off before sensitive work. Clearing the screen and clearing history are separate decisions.

Syntax

lil-terminal

clear [-h|-H]

Reference

clear

clear visible lil-terminal output

cls

alias for @clear

clear -h @history

clear visible lil-terminal output and command history

clear -H @history

clear visible lil-terminal output, command history and persistent transcript

History

The plain clear and cls forms affect only what is visible. With the @history module installed, -h also clears the browser command list. -H additionally deletes the bounded persistent terminal transcript managed by @history -l. Files and modules are never removed by these forms.

Practical guidance

In Minimum, plain clear works; -h and -H require Base and the history module.

Interactive sandbox preview

Run the prepared examples directly on the page. Their results are prebuilt and shown in the browser; no terminal command is executed on the server.

Clear visible lil-terminal output

Install and manage

Install the current compatible version. Choose Base for the complete feature set or Minimum for the reduced package; use upgrade to update a module that is already installed.

Base and Minimum are two packages of the same current module release, not separate command versions.

Base package

Install the complete package with local command reference and every published mode.

install clear

Minimum package

Install the reduced package. Local reference is omitted; help <cmd> -i opens the current server reference.

install clear -m

Exact public version

Install exactly this published version.

install clear -v 1.1.5

Check or update

Ask upgrade to check compatibility and replace the installed block only when needed.

upgrade clear

Remove module

Remove the extension block while leaving the core and unrelated modules intact.

install clear -u

Examples

Examples are copyable command lines, not actions executed by this website. Review paths, permissions and destructive flags before running them on a real project.

Clear visible lil-terminal output

clear

Preview only — the visitor’s terminal is not changed.
Screen cleared.

Alias for @clear

cls

Preview only — the visitor’s terminal is not changed.
Screen cleared.

cls is an alias of clear, useful when muscle memory comes from DOS or Windows terminals.

Clear · browser

clear -h

Preview only — the visitor’s terminal is not changed.
Screen cleared.
Browser command history cleared.

Clear · transcript

clear -H

Preview only — the visitor’s terminal is not changed.
Screen cleared.
Browser command history cleared.
Saved terminal transcript deleted.
Recording remains enabled if it was already on.

Clear · error

clear -x

Clear · mixed-options

clear -h -H

Clear · invalid

clear history

Clear · mixed-options

clear -H -h

Clear · browser

clear -h

Preview only — the visitor’s terminal is not changed.
Screen cleared.
Browser command history cleared.

Current public release

v1.1.52026-08-08

Cleaner alias reference

Keeps cls documented once as the @clear alias and removes duplicate alias forms from the history options.

# Version history

clear