
================================================================================
                         FRST COMPUTER — QUICK REFERENCE
                        Public Beta  /  frstcomputer.com
================================================================================


  GETTING STARTED
  ===============

  FRST boots to a shell prompt (%).  Type a command, press Enter.

  First steps:
    help                    see all commands
    todo                    open your task list
    fortune                 random wisdom
    pom                     phase of the moon
    man -k word             search the manual
    cat /n/local/readme.txt read the readme

  Explore the filesystem:
    ls                      list current directory
    ls /n/local/text        list the text directory
    cat /n/local/text/conscience.txt
    p /n/local/text/zen_life.txt   paged reading

  Set your clock (attune does this for you):
    timesync /n/dc


  THE SHELL (ZRC)
  ===============

  ZRC is an rc-like shell.  If you know Plan 9's rc, you're home.

  Pipes             ls | grep txt
  Redirection       echo hello > /n/local/notes.txt
  Variables         x = hello ; echo $x
  Lists             files = (a.txt b.txt c.txt)
  Substitution      echo `{date}
  Functions         fn greet { echo hello $1 }
  If / else         if (test -f foo) echo found
                    if not echo missing
  While             while (true) { echo tick ; sleep 1 }
  For               for (f in *.txt) echo $f
  History           up/down arrows recall prior commands
  Scripts           . /n/local/myscript.rc


  FILES
  =====

  ls [dir]          list files          cp src dst       copy
  cat file          print contents      mv old new       rename/move
  rm file           delete              mkdir dir        create directory
  stat file         file details        grep pat [file]  search
  wc file           count lines/words   glob pat         match filenames
  pwd               current directory   cd dir           change directory

  Writable storage is at /n/local.  Files persist across reboots.


  EDITORS
  =======

  vi [file]         vi editor (modes: normal, insert, command)
  se [file]         screen editor (no modes, just type)
  ed [file]         line editor (classic Unix ed)
  sam [file]        structural regex editor (Plan 9)
  sed 's/a/b/' f    stream editor
  p [file]          e-ink pager (Space=next, b=prev, q=quit)


  NETWORKING
  ==========

  FRST speaks 9P — the Plan 9 file protocol.  Every connection
  is a filesystem.

  attune              tune in to a data crystal (interactive wizard)
  gopher host         browse gopherspace
  finger [user@]host  finger protocol query
  telnet host [port]  interactive telnet session
  con target          raw connection (serial, TCP)

  Namespace:
  ns                  show mounted namespaces
  mount srv path      mount a 9P server
  bind src dst        overlay one path onto another
  srv dialstr [name]  dial and post to /srv


  GOPHER
  ======

  gopher jonsharp.net         connect to a gopher server

  Navigation:
    j / k / arrows            move cursor
    Enter / Right              follow link
    Left / Esc / h             go back
    Space / PgDn               next page
    b / PgUp                   previous page
    / text                     search on current page
    B                          add bookmark
    b                          show bookmarks
    q                          quit


  AETHER CHAT
  ===========

  LoRa mesh radio messaging.  No cell towers, no WiFi.

  chat                   open Aether Chat
  say msg                send a quick message

  Messages travel via LoRa at ~900 MHz.  Other FRST devices
  in range relay automatically.


  AMUSEMENTS
  ==========

  wumpus      hunt the beast           hangman     guess the word
  tetris      falling blocks           snake       eat and grow
  chess       two-player chess         blackjack   beat the dealer
  arithmetic  math quiz
  fractal     Mandelbrot renderer      pom         phase of moon
  morse text  encode to Morse code     mavis       typing trainer

  Zork & Interactive Fiction:
  zork        The Great Underground Empire
  lostpig     Award-winning IF
  frotz file  play any Z-machine story


  WOZ — APPLE 1 EMULATOR
  =======================

  A Replica 1 with 65C02 CPU, Woz Monitor, Integer BASIC,
  and Krusader assembler.

  woz                      start the emulator

  At the Woz Monitor (\):
    0000.00FF               examine memory range
    0300: A9 01 8D 00       write bytes to memory
    E000R                   run Integer BASIC
    F000R                   run Krusader assembler
    Ctrl-C                  return to ZRC


  FORTH
  =====

  forth                    start pForth interpreter
  2 3 + .                  prints 5
  : SQUARE DUP * ;         define a word
  7 SQUARE .               prints 49
  BYE                      exit Forth


  SYSTEM
  ======

  man cmd              read the manual page
  man -k word          search the manual
  help                 the short command list
  date                 show date and time
  timesync /n/dc       set the clock from a crystal
  df                   filesystem space
  ps                   threads, with stack use
  uptime               how long since boot
  power                power state and idle time
  handle name          claim your name on a board
  clear                clear screen
  reboot               restart

  Keyboard Shortcuts:
    Up / Down          command history
    Ctrl-C             cancel current command
    Ctrl-D             exit shell
    Ctrl-L             clear screen
    Ctrl-U             kill line
    Ctrl-W             delete word
    Ctrl-Z             suspend an app (fg resumes)
    F1 / F2 / F3       switch between the three shells
    Ctrl-A c           start another shell

  Power Management:
    The display auto-dims after 2 min idle, goes dark
    after 5 min.  Press any key to wake.


  HARDWARE
  ========

  Processor       ESP32-S3 dual-core @ 240 MHz, 8 MB PSRAM
  Display         7.5" e-ink, 800x480, black and white
  Radio           Semtech SX1262 LoRa (Sub-GHz mesh)
  Keyboard        BLE via 9P over L2CAP
  Storage         16 MB flash: 8 MB LittleFS + NVS + OTA
  Frontlight      WS2812 LEDs, adjustable brightness
  Connectivity    BLE 5.0, LoRa, WiFi (via data crystal)
  Boot            MCUboot with secure boot and OTA


  PHILOSOPHY
  ==========

  Everything is a file.
  Every peripheral is a network peer.
  There is no app store.
  Simple by design.

  For the few of us.


================================================================================
  FRST Computer  /  Public Beta  /  frstcomputer.com
================================================================================
