Terminal client

TUI launch options

Connection, startup scripts, logs, content, and HTTP policy.

Connect

./holtburger-cli --host SERVER --port 9000 --account ACCOUNT --password PASSWORD
OptionShortMeaning
--server ADDRESS:PORT-sCombined server endpoint
--host HOST-hHost when not using the combined endpoint; defaults to 127.0.0.1
--port PORT-pPort; defaults to 9000
--account NAME-aAccount name
--password PASSWORD-PAccount password
--character NAME-cCharacter to enter
--content DIR—Explicit prepared-content directory

Use the platform quickstart for the executable or Flatpak launch command. Extract the complete bundle before connecting.

Script startup and disconnects

OptionMeaning
--run NAMEQueue a script to start when the character is ready
--run-args TEXTArguments for that queued script; requires --run
--auto-quit, -QExit immediately on disconnect

After saving the hello example, add --character Bestie --run hello --run-args 'a first test' to your connection command.

-Q does not mean quiet or headless. Use an external supervisor if you want an exit to cause a restart.

Logs and diagnostics

OptionMeaning
--log PATH, -l PATHWrite chat and game-system messages
--debug-log PATHWrite Rust debug logs
-v, -vv, -vvv, -vvvvShow warn, info, debug, or trace logs in the TUI
-V, -VV, -VVV, -VVVVSet those levels for --debug-log; requires that file option
--capture PATHRecord session traffic for diagnostics
--helpShow launch help
--versionShow version

Note that -h is the host option; use --help for help. Review logs and captures before sharing them; remove account credentials from reports.

Script HTTP policy

OptionMeaning
--script-fetch-allow-host HOST:PORTAllow that exact host and port; repeat for multiple hosts
--script-fetch-timeout-ms NUMBERRequest timeout; defaults to 5000 ms
--script-fetch-max-response-bytes NUMBERResponse size limit; defaults to 262144 bytes

Without explicit allow-host options, only localhost:9999 is allowed. See HTTP integrations for usage.

Script directories

OptionEnvironmentDefault
--script-dir DIRSCRIPT_DIR./scripts/ for personal scripts and preferences
--script-bundle-dir DIRSCRIPT_BUNDLE_DIRscripts/ beside the executable for shipped scripts

CLI options override environment values, as --content DIR overrides HOLTBURGER_DEFAULT_CONTENT. Relative script paths are resolved from the launch working directory. Empty selected paths are errors. A selected bundle directory must already exist; a personal directory can be created when saving preferences.

Local scripts with matching basenames override bundled scripts. /scripts reports discovered scripts and directories.