docs(repl): add documentation about repl

Author: SuperFola

content/docs/prologue/getting_started.md

@@ -68,9 +68,9 @@ You will want to learn the language first: [Learning ArkScript](/docs/tutorials/
 
 Then you can experiment with either:
 
-- [try the online playground](https://playground.arkscript-lang.dev), so that you don't have to install anything
+- [try the online playground](https://playground.arkscript-lang.dev), so that you don't have to install anything,
 - [use Docker](/docs/prologue/building#using-docker), to avoid clutering your computer with dependencies and compilers,
-- or [install it on your machine](/docs/prologue/building#installing-from-a-release) via one of our releases
+- or [install it on your machine](/docs/prologue/building#installing-from-a-release) via one of our releases. You can quickly try code using [the REPL](/docs/reference/repl)
 
 ## I want to contribute!
 

content/docs/reference/repl.md

@@ -0,0 +1,45 @@
+---
+title: "REPL"
+slug: "repl"
+description: ""
+date: 2026-01-01T16:52:54+02:00
+lastmod: 2026-01-01T16:52:54+02:00
+draft: false
+weight: 505
+---
+
+ArkScript REPL can be launched by calling `arkscript` without any file argument.
+
+It will look for the `ARKSCRIPT_REPL_STARTUP` environment variable to optionally preload code. See [the getting started guide](/docs/prologue/building/#environment-var-setup) to configure it.
+
+## REPL builtins
+
+- `(repl:history)` returns the REPL history as a string
+- `(repl:save filename)` saves the REPL history to a file
+- `(repl:load filename)` loads a file into the REPL (copies its content to the current session, to avoid path problems with imports)
+
+## REPL commands
+
+- `help`: display this message
+- `quit`: quit the REPL
+- `save`: save the history to disk
+- `history`: print saved code
+- `reset`: reset the VM state
+
+## REPL controls
+
+- **Home**: move to start of line
+- **End**: move to end of line
+- **Control** + **Left**: move cursor one word left
+- **Control** + **Right**: move cursor one word right
+- **Control** + **Up**: show previous hint
+- **Control** + **Down**: show next hint
+- **Control** + **U**: delete current line
+- **Control** + **W**: delete last word
+- **Control** + **K**: delete until end of line
+- **Control** + **R**: incremental search
+- **Control** + **C**: abort line
+- **Control** + **L**: clear screen
+- **Control** + **D**: send EOF, quit REPL
+- **Control** + **T**: transpose characters (invert the 2 characters *before* the cursor*)
+

hugo_stats.json

@@ -681,6 +681,7 @@
       "parameter-36",
       "parameter-37",
       "parameter-38",
+      "parameter-39",
       "parameter-4",
       "parameter-5",
       "parameter-6",
@@ -757,6 +758,9 @@
       "removeprefix",
       "removesuffix",
       "repeat",
+      "repl-builtins",
+      "repl-commands",
+      "repl-controls",
       "repl-read-eval-print-loop",
       "replace",
       "results",