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

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.