App::AnteREPL
anterepl combines immediate Perl execution with an in-memory, numbered
program and an editable scrolling screen inspired by the C64 BASIC prompt.
The startup banner is *** PERL ANTE REPL V0.1 ***.
Screen editing inserts characters by default; Insert toggles overwrite mode. Move up, edit an earlier entry, and press Enter to replace its result directly below it. Later entries stay intact while they fit, without an added blank spacer. The cursor follows the result onto the next row; Esc moves to fresh input at the bottom.
AUTO
say "hi"
say "there!"
AUTO OFF
LIST
5 say "hi";
10 say "there!";
RUN
hi
there!
AUTO supplies numbers in increments of 5. AUTO OFF, Ctrl-C, or Ctrl-D ends entry.
Entries stay quiet by default; LIST shows numbers, or use AUTO ECHO ON.
Outside AUTO, ordinary Perl executes immediately. EDIT opens the stored
program in $EDITOR; EDIT ENV edits %ENV using VAR=value lines.
CLS clears the screen and resize bank while keeping the stored program, live Perl
variables, and %ENV. Use LIST to display the program again.
All REPL commands and subcommands are uppercase, including LIST, AUTO OFF,
ENV SET, DUMP, and PEEK. Lowercase Perl keywords and defined functions
retain their meaning; immediate lists follow the shorthand rules below.
Filenames, environment
names, values, and Perl code retain their case. EVAL executes immediately;
lowercase eval is ordinary Perl.
A command-like bareword such as cls gets a short try, "CLS". spelling hint.
CD directory and CHDIR directory change this session's directory; ordinary
Perl such as chdir $ENV{HOME} still works. Ctrl-C cancels or interrupts and
reminds you how to leave with QUIT, QUIT!, or Ctrl-D.
Shift+Enter (when the terminal distinguishes it) or Ctrl-N inserts a newline
without submitting, including inside an editable multiline EVAL block.
EVAL sub triple { return 3 * shift; } defines a session-only function in the
current workspace. Immediate code and RUN can call it; it does not enter
the numbered program or appear in SAVE. FUNCTIONS lists defined functions
in the current workspace, including imports. Redefining a named subroutine
through ordinary Perl replaces it with the usual warning, without confirmation.
Shorthand redefinitions ask first, as described below.
Call it as say triple 14. Bare calls use Perl's normal precedence and
prototype rules; parentheses remain available when needed for grouping.
Command shortcuts need one shifted letter: E evaluates, L lists, R runs,
C clears the screen, H shows HELP, and Q quits. Digits resolve collisions:
E1 edits, L1 loads, R1 renumbers. Every command and option has a shortcut;
H lists the complete table. Existing long commands still work.
Destructive shortcuts ask Continue? [y/N]; append ! to skip the question,
for example D1! 10-30, R2!, S! demo.pl, or Q!. New files and values do
not prompt. Piped input requires ! for a destructive shortcut.
Immediate definitions include:
E s triple return 3 * shift
E a colors red, blue
E ar names Ada, Bob
E h options color => blue
E hr record name => Ada
With AUTO off, a one, two, threee defines persistent @a with those exact
strings. Perl keywords and existing functions take priority over bare destination
names. E reserves the five spaced definition tags; EVAL always accepts literal
Perl. Normal quotes and q/qq/qw/regex operators work inside shorthand lists.
Other Perl expressions
go in parentheses. Replacing existing destinations asks first; E! a colors green and colors! green, blue force replacement. Literal EVAL and arbitrary
Perl retain their usual side effects. See the complete grammar and review checklist.
For a hands-on test session, follow the human QA/QC walkthrough.
A screen-sized work area
The white border encloses the working "VRAM", like a sheet of graph paper.
A single-line command legend stays below it. An 80x24 terminal gives 78x21 editable
cells; resizing adjusts the interior. Output scrolls old rows away; long lines wrap.
The legend shows commands to type and submit with Enter, such as H for HELP.
The input loop blinks the cursor every half second; insert requests a bar
and overwrite a block, subject to terminal shape support. CLS clears the interior and retains the frame.
--plain uses normal terminal input without the frame, legend, or cursor styling.
Interactive exits print: Thank, we hope something good happens to you today!
PageUp cannot reach an invisible history.
Making the window smaller cuts off rows and columns. AnteREPL warns and keeps
one separate copy from before the shrink. Making it bigger adds empty cells:
lost text does not return on its own. To get the copy back, enlarge to the size
in the warning and type RECOVER. That replaces the current screen without
running code. CLS forgets the copy; ordinary scrolling does not make one.
Your numbered program and live Perl values are separate from this sheet.
LIST brings source back into view; SAVE writes source to disk. Use EDIT
for code too large to fit on the screen. An entry clipped by the boundary
cannot run as partial Perl. HELP pauses by screenful in screen mode.
Install and run
Requires Perl 5.16 or newer. Install a release archive:
cpanm ./App-AnteREPL-0.01.tar.gz
anterepl
Or install from this checkout:
perl Makefile.PL
make test
make install
Run without installing with perl -Ilib script/anterepl. Native Windows
screen mode also needs Term::ReadKey and an ANSI-capable terminal. Unix can
use the core POSIX backend. anterepl --plain disables screen editing.
Learn to use it
- User guide and tutorials
- First session
- Commands
- Troubleshooting
- Offline:
HELP,anterepl --help, orperldoc App::AnteREPL.
LOAD program.pl reads ordinary Perl; SAVE remembers that file and format.
.bperl files preserve editing numbers. LIST supports ranges, slow output,
and pause/step controls. Move up into a listed row, edit it, and press Enter to
replace that program line. DUMP and PEEK inspect live values.
Source files do not save runtime variables. my variables last for one
evaluation; use package variables for values shared across commands. Native
Windows screen behavior has not yet been verified on Windows.
Development
prove -lr t runs the tests. dzil test and dzil build use dist.ini.
Dist::Zilla is a maintainer dependency, not needed to install or run a release.
See CONTRIBUTING.md
for release contents and optional terminal checks.
Copyright (c) 2026 Brett Estrade. Licensed under the same terms as Perl itself.
Talk material
The Winter 2026 PCC talk draft includes an editable Beamer tutorial and overview, speaker notes, a rendered PDF, and rehearsal examples. Presentation files are excluded from the CPAN distribution.