These flags are passed when launching logana from the shell:
Flag Description
<file>File or directory to open. Omit to read from stdin. -f, --filters <path>Preload a saved filter set (JSON). Filters are applied in a single pass during indexing and remain active for interactive use. -i, --include <args>Add an include filter. Accepts the same arguments as :filter. May be repeated. Examples: -i "error", -i "--field level=ERROR" -o, --exclude <args>Add an exclude filter. Accepts the same arguments as :exclude. May be repeated. Examples: -o "debug", -o "--field level=debug" -t, --timestamp <args>Add a date/time range filter. Accepts the same arguments as :date-filter. May be repeated. --tailStart at the end of the file and enable tail mode. Combined with --filters, the last matching line is available immediately after loading. --mcp [PORT]Start the embedded MCP server on launch. Port defaults to 9876. See MCP Server . --headlessRun without TUI — apply filters and write matching lines to stdout or --output. --output <path>Write headless output to a file instead of stdout. Requires --headless.
Press : in normal mode to open command mode. Tab completes commands, flags, colors, themes, and file paths. Command history is navigable with Up / Down.
Command Description
:filter <pattern>Add an include filter (show only matching lines) :filter --field <key>=<value>Add a field-scoped include filter (e.g. level=error) :exclude <pattern>Add an exclude filter (hide matching lines) :exclude --field <key>=<value>Add a field-scoped exclude filter (e.g. level=debug) :date-filter <expr>Add a date/time range filter :set-color [--fg COLOR] [--bg COLOR]Set highlight color for the selected filter :save-filters <file>Save current filters to a JSON file :load-filters <file>Load filters from a JSON file
See Filtering , Date & Time Filters , and Field Filters for full details.
Command Description
:<N>Jump to line N (e.g. :500)
Command Description
:open <path>Open a file or directory :close-tabClose the current tab
Command Description
:wrapToggle line wrap on/off :tailToggle tail mode (auto-scroll on new content) :rawToggle raw mode — bypass the format parser and show unformatted log lines; title shows [RAW] when active :level-colorsOpen the level colors dialog — toggle coloring per level (TRACE, DEBUG, INFO, NOTICE, WARNING, ERROR, FATAL); INFO/TRACE/DEBUG/NOTICE are off by default :value-colorsOpen the value colors dialog — toggle coloring for HTTP methods, status codes, IPs, UUIDs, and process/logger names :set-theme <name>Switch the color theme
Command Description
:otel [port]Open an OTLP gRPC receiver tab (default port 4317) :otel --http [port]Open an OTLP HTTP/JSON receiver tab (default port 4318)
See OTel Collector for full details.
Command Description
:enable-mcp [--port N]Start the embedded MCP server (default port 9876) :disable-mcpStop the MCP server
See MCP Server for full details.
These commands control how the current tab handles incoming data from a file watcher or stream (stdin, Docker).
Command Description
:stopPermanently stop all incoming data for the current tab — drops the file watcher and/or stream :pauseFreeze the view; the background watcher/stream keeps running. Title shows [PAUSED] :resumeResume applying incoming data; the latest snapshot is applied immediately
Note: :pause / :resume are non-destructive — no data is lost while paused. :stop is permanent; to resume watching a file after stopping, reopen it with :open.
Command Description
:fields [col ...]Set visible columns (e.g. :fields timestamp level message) :hide-field <col>Hide a single column :show-field <col>Show a previously hidden column :show-all-fieldsReset to default column display :select-fieldsOpen an interactive column picker :show-keysShow field keys alongside values (e.g. method=GET) :hide-keysShow only values, hiding field keys (default)
Command Description
:export <file> [-t <template>]Export annotations to a file (default template: markdown) :dockerPick and stream a running Docker container :dltPick and stream from a DLT daemon over TCP
Command Description
:resetRestore all settings to defaults and clear all persisted state
Command mode supports multi-tier tab completion:
Color names — after --fg or --bg flagsTemplate names — after -t / --template flags in :exportFile paths — for :open, :save-filters, :load-filters, :exportTheme names — for :set-themeCommand names — for everything else
Press Tab / Shift+Tab to cycle through completions. A highlighted suggestion appears in the hint area; Space accepts it.