Starts an interactive REPL for testing PTC-Lisp expressions.

Usage

mix ptc.repl                      # Interactive REPL (default)
mix ptc.repl -l user.clj          # Load user-code file, then interactive
mix ptc.repl --prelude crm.clj    # Attach a deployment prelude
mix ptc.repl --log-prelude        # Attach the built-in turn-log prelude
mix ptc.repl --prelude crm.clj -e "(ns-publics 'crm)"
mix ptc.repl --prelude crm.clj --show-prompt-inventory
mix ptc.repl -e "(+ 1 2)"         # Eval and print result
mix ptc.repl --upstreams-config upstreams.json -e "(tool/servers)"
mix ptc.repl -e "(def x 1)" -e "(* x 2)"  # Chain evals (memory persists)
mix ptc.repl script.clj           # Run script file
mix ptc.repl -                    # Run from stdin

Options

• -e, --eval - Evaluate expression and print result (can be repeated)
• -l, --load - Load file before entering interactive mode
• -p, --prelude - Compile a deployment prelude file and attach it to every evaluation (protected namespaces, public exports, discovery). SEPARATE from -l/--load, which loads ordinary user code.
• --log-prelude - Attach the built-in read-only log/ introspection prelude to the REPL's default in-memory turn-log sink. Mutually exclusive with --prelude until general prelude composition is defined.
• --show-prompt-inventory - Print the prelude's compact prompt inventory (the same rendering SubAgent execution injects) before evaluating.
• --upstreams-config - Root upstream JSON config path (or PTC_RUNNER_UPSTREAMS)
• --max-tool-calls - Per-evaluation tool/call cap
• --max-catalog-ops - Per-evaluation discovery form cap
• --upstream-call-timeout-ms - Per-upstream-call timeout
• --max-upstream-response-bytes - Per-upstream response cap
• --catalog-mode - Catalog exposure mode: auto, inline, or lazy
• --catalog-snapshot-mode - Catalog snapshot mode: live or frozen
• -h, --help - Print this help

Features

• Evaluate PTC-Lisp expressions interactively
• Multi-line input: continues prompting until parens are balanced
• Turn history: *1, *2, *3 reference last 3 results
• Memory persists between evaluations
• Optional upstream runtime for (tool/call ...), (tool/servers), dir, doc, meta, and apropos
• Exit with Ctrl+D

Example Session

ptc> (+ 1 2)
3
ptc> (* *1 10)
30
ptc> {:sum *1, :product *2}
%{sum: 30, product: 30}