ende repl

Special variables

The REPL provides a couple of special variables, that are always available:

Ende 2026.10.17
exit using ctrl+d or close()
> "hello world!"
"hello world!"
> _
"hello world!"
> const foo = "bar";
undefined
> _
undefined

Special functions

The REPL provides several functions in the global scope:

--eval flag

--eval flag allows you to run some code in the runtime before you are dropped into the REPL. This is useful for importing some code you commonly use in the REPL, or modifying the runtime in some way:

ende repl --allow-net --eval 'import { assert } from "jsr:@ende/assert@^2026.10.15"'
Ende 2026.10.17
exit using ctrl+d, ctrl+c, or close()
> assert(true)
undefined
> assert(false)
Uncaught AssertionError
    at assert (https://jsr.io/@ende/assert/1.0.0/assert.ts:21:11)
    at <anonymous>:1:22

--eval-file flag

--eval-file flag allows you to run code from specified files before you are dropped into the REPL. Like the --eval flag, this is useful for importing code you commonly use in the REPL, or modifying the runtime in some way.

Files can be specified as paths or URLs. URL files are cached and can be reloaded via the --reload flag.

If --eval is also specified, then --eval-file files are run before the --eval code.

ende repl --eval-file=https://docs.ende.sh/examples/welcome.ts,https://docs.ende.sh/examples/local.ts
Download https://docs.ende.sh/examples/welcome.ts
Welcome to Ende!
Download https://docs.ende.sh/examples/local.ts
Ende 2026.10.17
exit using ctrl+d or close()
> local // this variable is defined locally in local.ts, but not exported
"This is a local variable inside of local.ts"

Relative Import Path Resolution

If --eval-file specifies a code file that contains relative imports, then the runtime will try to resolve the imports relative to the current working directory. It will not try to resolve them relative to the code file's location. This can cause "Module not found" errors when --eval-file is used with module files:

ende repl --eval-file=https://jsr.io/@ende/encoding/1.0.0/ascii85.ts
error in --eval-file file https://jsr.io/@ende/encoding/1.0.0/ascii85.ts. Uncaught TypeError: Module not found "file:///home/_validate_binary_like.ts".
    at async <anonymous>:2:13
Ende 2026.10.17
exit using ctrl+d or close()
>

Tab completions

Tab completions are a crucial feature for quick navigation in the REPL. After hitting tab key, Ende will now show a list of all possible completions.

ende repl
Ende 2026.10.17
exit using ctrl+d or close()
> Ende.read
readTextFile      readFile          readDirSync       readLinkSync      readAll           read
readTextFileSync  readFileSync      readDir           readLink          readAllSync       readSync

Keyboard shortcuts

ENDE_REPL_HISTORY

By default, Ende stores REPL history in an ende_history.txt file within the ENDE_DIR directory. The location of your ENDE_DIR directory and other resources, can be found by running the ende info.

You can use ENDE_REPL_HISTORY environmental variable to control where Ende stores the REPL history file. You can set it to an empty value, Ende will not store the history file.

repl