Skip to content

Templates

A template is a command or a script you run on any machine from the workspace sidebar. Templates in the header manages them.

Templates page: table with name, type, preview, note, author, created, usage, root and visibility, with filters, Export, Import and New Template

Edit Template dialog: name, type, content with {{service}} and {{lines}}, tags, note, visibility

Field
NameShown in the list and the sidebar
TypeCommand: one line, typed into the terminal. Script: a multi-line file, written to a temp file on the machine and executed
ContentThe command or script. Write {{name}} wherever a value should be asked for
TagsComma-separated: letters, digits, - and _. The workspace sidebar filters by them
NoteWhat it does; shown in the list
VisibilityPrivate (only you) or Shared (every admin)
Requires sudoThe Root column, and a lock on the template’s card in the workspace. Asks for the machine’s sudo password before running

Only the author can edit or delete a template; other admins see a shared one without the edit and delete buttons.

A {{name}} in the content — lowercase letters, digits and _ — is asked for before Run, Insert or Report.

Service log parameters dialog asking for service and lines

Values are inserted exactly as typed, not shell-quoted — quote them in the template if needed. The last values are remembered per machine in your browser, in plain text, so keep passwords out of parameters. A template whose command uses {{path}} can be run on an open file from the editor’s Run a check… — there the path is inserted shell-quoted.

Export downloads every template you can see as woho-templates.json. Import adds the templates of such a file and skips names you already have. A starter pack of diagnostics — service log and status, failed units, disk, listening ports, kernel messages, time sync, memory, addresses — is at starter-templates.json.

The sidebar’s Templates section lists yours and the shared ones. The chips above it filter by tag, the box searches; Alt+F focuses it, Alt+N creates a new template, + too.

Template dialog in the workspace: the command with its parameters, and Run, Insert, Copy, Report and Run in new terminal

Click a card:

ActionDoes
RunClears the prompt of the open terminal, types the command, presses Enter. With no terminal open, opens one first
InsertTypes it without Enter, for you to read before running
CopyTo the clipboard, as written
ReportRuns it in the background and opens a Report tab with the output, exit status and time. Download it, Save it as a note on the machine, or Copy it
Run in new terminalAlways a fresh terminal tab

Report tab Disk usage with the command's output and Download, Save, Copy buttons

A template that requires sudo asks for the password in a dialog; the password is sent to the machine for that run and not stored. Runs are in History with secrets redacted.