ZeroTrace Companion
Terminal
Direct command-line access to the connected device — for power users, troubleshooting, and scripting.
The terminal is Companion's "raw access" view. Type a command, the device receives it; the device responds, you see it. Everything the dashboard does behind the scenes is visible here, and anything the dashboard does not expose is reachable through the terminal.
For power users, the terminal is often the primary view — faster than clicking through dashboards once you know the command set.
Layout
The terminal has three regions:
| Region | What it does |
|---|---|
| Display area (top) | Scrollback of every command sent and every response received, with timestamps |
| Input field (bottom) | Where you type the next command |
| Toolbar (top-right) | Clear, save session, font size, search |
Output is colour-coded: green for success responses, red for errors, neutral for plain output. Tables returned by the device render as tables. JSON responses pretty-print.
Sending commands
Type a command and press Enter. The command is transmitted over the serial connection; the device's response renders in the display area as it arrives.
For multi-line commands or long scripts, paste them in — the terminal sends each line in sequence.
Command history
Up and Down cycle through the commands you have sent. History is preserved across sessions; configure the limit in Settings → Terminal (default 100, max 1000).
The history is per-device — so the commands you ran against a HID device do not pollute your AirLeak history.
Tab completion
Where the device firmware supports it, Tab requests completion for the partial command you have typed. ZeroTrace HID devices ship with a built-in completion table for the standard command set.
Search the scrollback
Ctrl+F opens a search bar. Find any text in the scrollback; matching lines highlight as you type. Useful when you've run dozens of commands and need to find one specific response.
Clear the display
Ctrl+L (or the Clear button in the toolbar) wipes the display. The history is not cleared — only the visible scrollback. Re-run a command from the history to bring it back.
Save the session
Ctrl+S (or the Save button) writes the current scrollback to a file. Choose:
- Plain text — readable log.
- Markdown — formatted for reports.
- JSON — structured per-command for scripting.
Useful for documenting troubleshooting sessions, capturing evidence for a support ticket, or building a reproducible script from an interactive session.
Font size and wrapping
Ctrl+Plus / Ctrl+Minus adjust the terminal font size. Ctrl+0 resets to default. The setting persists across launches.
The Wrap toggle (in Settings → Terminal) controls whether long lines wrap or scroll horizontally. Default is wrap.
Cancelling a running command
Ctrl+C sends the abort signal to the device. For most ZeroTrace firmware, this stops the in-progress command and returns the device to the prompt.
For commands that block (long-running scripts, infinite loops), this is the way to recover without disconnecting.
For exploring an unfamiliar device, type help first. ZeroTrace firmware ships a built-in help command that lists every supported command. Then help <command> for per-command details.
Common command examples
For ZeroTrace HID devices, common commands include:
| Command | What it does |
|---|---|
information system | Returns the structured device-info JSON the dashboard shows |
wifi sta list | Lists known Wi-Fi networks the device can connect to as a station |
script list | Lists the scripts stored on the device |
script run <name> | Executes a stored script |
reboot | Soft-reboots the device |
For the full HID command set, see ZeroTrace HID scripting language.
For BLE Logger commands, see ZeroTrace BLE Logger.
When to prefer the terminal over the dashboard
- You are running a sequence of commands that the dashboard does not expose.
- You are debugging a device that's behaving oddly — the raw responses are more diagnostic than the dashboard's filtered view.
- You are scripting an interactive setup and want to capture every step.
- You prefer typing to clicking. The terminal is keyboard-first.
The dashboard and terminal coexist — use whichever fits the task in front of you.