ULTIMATEEXPERIMENTSCommodore 64 · Work in progress

ReadyFS interactive editor and REU output history

The full interactive application is readyfs-overlay.prg, with readyfs-overlay-lab.d81 mounted on IEC device 8. Keep all 28 sidecars on that disk; startup caches them in the REU. readyfs.prg is the smaller monolithic diagnostic variant and retains its basic input reader. Use the overlay application for this editor, option shorthand, scripts, and scrollback.

For a concepts-first walkthrough with screenshots and a full command reference, see the illustrated user guide or its standalone print edition.

Batch scripts

Use RUN script-path [arg1 ... arg9] or RU. The RUN reference documents session/persistent variables, %0–%9, conditions, counter loops, same-file CALL and shared subroutine inputs, result handling and all limits. Its BACKUP.SEQ example is demonstrated in the appended physical video chapter. Separate-file CALL, nested RUN, SHIFT and FOR are not supported. TYPE streams the script; use F1/F3 output history to read earlier lines.

Editing

The logical command can contain 255 bytes. Four visible input rows each hold 36 command characters, following rf> or ..> . The window follows the cursor through longer commands. Wrapping changes presentation; it does not insert bytes into the command. Paths and text containing spaces still need quotes, and the existing parser has a twelve-token limit.

Key Action
Left / Right Move within the command
Home / Shift+Home Beginning / end of the command
Delete Delete the character before the cursor
Insert Toggle insert / overwrite (ov>); initially insert
Up / Down Older / newer executed command; Down past newest restores the draft
Return Execute the logical command
Trailing backslash + Return Replace the backslash with a space and continue
Return with an open double quote Continue the quoted command with a space
Shift+Return or F7 Insert a joining space and continue
Run/Stop Cancel the draft

Continuation joins parts of one command. It does not execute a batch of commands and does not add a newline to a file's contents. The same 255-byte limit applies to the joined command. Closing a quote and pressing Return runs it. At the limit, further printable characters are ignored; Delete frees room.

Command history uses 32 REU records of 256 bytes. Up/Down recall remains editable. The unfinished draft, cursor position, and insert mode are preserved in separate REU storage while walking history. History does not persist across application restart.

Output history

At the prompt, F1 enters the most recent output page and then moves older. F3 moves newer and, at the newest page, returns to the live editor. Commodore+Up/Down provide the same paging actions. Run/Stop or Return returns to live output immediately. F3 at the live prompt leaves the editor alone.

The output ring stores 800 physical rows, with both 40 screen characters and 40 color bytes per row: 64,000 bytes in a separate REU bank. It captures completed rows continuously, including wrapped output and command echoes. clear clears the live screen while retaining scrollback. Once full, the ring replaces its oldest row. Pages contain up to 23 output rows. The live 1,000-byte screen and 1,000-byte color map are preserved in REU and restored exactly when leaving history, including the current draft.

The editor and history-browser legends are excluded from the output ring. Paging is available from the command prompt; existing -- more -- directory prompts still wait for a key before continuing enumeration.

Screen work

Ordinary editing does not clear or repaint the screen:

The C64's ordinary input-cursor blink still operates. The host screen-write oracle counts application drawing separately from the cursor.

Exact short names

Names match complete tokens, case-insensitively. Prefix abbreviations are not accepted, so adding future commands cannot silently change the meaning of an existing short name.

Short Command Short Command
q exit h help
pb probe pf profile
nt native dv drives
pw pwd hi history
cl clear cd cd
al alias ua unalias
cf config d / ls dir
tr tree st stat
vl volume mt match
ty / cat type cp copy
mv move rn / ren rename
dl / rm delete cm / verify compare
nw new wr write
ap append md mkdir
rd rmdir mo mount
um dismount sw swap
ca capabilities ss status
fi find hd head
tl tail cr crc32
ts test ru run
fm format
Short option Long option
-r --recursive
-w --dry-run (same preview effect as --whatif)
-x VALUE --exclude VALUE
-f --force
-i VALUE --include VALUE
-l --line
-n VALUE --name VALUE
-np --native-pattern
-t VALUE --type VALUE
-y --yes
-a --apply
-c --continue
-lb VALUE --label VALUE
-id VALUE --id VALUE
-ds --disposable

Options are expanded only after mandatory positional arguments. Values of exclude/include/name/type/label/id remain literal, even when they look like an option. Short names preserve the existing command's validation, confirmations, and ownership requirements; they do not bypass them.

Examples:

hd 8:/rfview 2
cp u:/SOURCE u:/DEST -r -w -x "*.bak"
fi 8:/ -i "*.prg"

Layout and verification

REU banks are reserved relative to the detected size:

The old whole-page scrollback reservation remains unused in the session bank so existing configuration/action regions retain their addresses.

make readyfs checks host behavior, UCI contracts, flat assembly DMA calls, sidecar size limits, resident/KERNAL scratch separation, and REU disjointness. readyfs_ui_test.c exercises minimal screen writes, insertion/deletion, 255-byte bounds, viewport changes, editable history with draft restoration, continuation, and literal-valued option aliases. VICE checks the actual C64 buffer and screen. start_readyfs_c64u_editor_terminal.sh runs the read-only physical suite at 1/16/64 MHz and restores the saved CPU settings and empty Drive A. It refuses occupied or differently configured Drive A.