CLI
The Ferret CLI is the primary tool for working with FQL scripts. Use it to execute queries, start an interactive shell, debug scripts, format source code, compile to bytecode, manage modules and browser instances, and configure persistent settings.
All commands accept --log-level, --log-output, and --log-file flags for controlling log output. Settings can be persisted through the config command or environment variables with the FERRET_ prefix. See Config for details.
Setup
Install
Install, update, and verify the Ferret CLI.
Execution
Run
Execute FQL scripts from files, inline expressions, stdin, or compiled artifacts.
Interactive
REPL
Launch an interactive FQL shell for experimenting with queries.
Debugging
Debug
Debug FQL scripts interactively with breakpoints, stepping, and variable inspection.
Validation
Check
Verify FQL scripts for syntax and semantic errors without executing them.
Formatting
Fmt
Format FQL scripts to a consistent style.
Compilation
Build
Compile FQL scripts into bytecode artifacts for faster execution.
Introspection
Inspect
Disassemble compiled programs and examine bytecode, constants, and source spans.
Browser runtime
Browser
Start and stop managed browser instances for browser-backed scripts.
Modules
Mod
Discover, install, initialize, and publish Ferret modules.
Configuration
Config
Manage persistent CLI settings for runtimes, browsers, and logging.