Skip to Content
ReferenceCLIOverview

CLI Reference

Lightpanda ships as a single binary. You call it with a command name, followed by the command’s arguments:

lightpanda <command> [arguments]

The available commands are:

CommandDescription
agentStarts an interactive AI agent that can browse the web
fetchFetches the specified URL
helpDisplays this message
mcpStarts an MCP (Model Context Protocol) server (stdio or HTTP)
runRuns a saved script (no LLM), then exits
serveStarts a WebSocket CDP server
versionDisplays the version of lightpanda

Use lightpanda help <command> for more information about a command.

Every command also accepts a shared set of common options.

help

Show the command list above, or lightpanda help <command> for one command’s own reference.

lightpanda help [command]

run

Run a saved script, then exit. No LLM calls, no API key needed. See how to run a saved script.

lightpanda run script.js
usage: lightpanda run <SCRIPT> [COMMON_OPTIONS]
 
Arguments:
<SCRIPT>
          Path to a .js script to run, then exit. Produce one with
          `lightpanda agent --task "..." --save script.js`, or `/save` from
          the agent REPL.
          Caution: .js files can contain evaluate(...) calls that run
          arbitrary JavaScript in the page. Only run scripts you trust, the
          same way you would a shell script.

The command also accepts the common options.

Find the script format in the PandaScript reference.

version

Displays the version of lightpanda.

lightpanda version
usage: lightpanda version [OPTIONS]
 
options:
  --check
          Checks whether a newer release of lightpanda is available. When one is
          found, prints the running version, the latest release, and how to
          update.
BenchmarksFetch