Productivity

Snippets

Save commands you run often, fill in values each time, and run them on several machines at once.

Creating a snippet

  1. Open the Snippets tab. Tap Snippets in the bottom bar.

    Snippets tab with snippets grouped under General, Homelab and WorkSnippets tab with snippets grouped under General, Homelab and Work
  2. Create a new snippet. Tap the + button. Fill in Group, Name, and Command.

    • To make an argument, wrap a word in double curly braces, for example journalctl -fu {{service}}. The word appears under Arguments.
    • Optionally set a default value for each argument. Leave one blank to be asked from scratch.
    Edit snippet form with group, name, a command with a service argument, and the Arguments section with default nginxEdit snippet form with group, name, a command with a service argument, and the Arguments section with default nginx
  3. Save. Tap Save.

Using a snippet in a session

  1. Open a session. Connect to a machine.

  2. Open the action dock. Tap the round floating button, then Insert snippet. A snippet can also sit on the key toolbar as its own key.

  3. Pick a snippet. Search or browse, then tap it.

  4. Fill in arguments. If the snippet has arguments, a dialog asks for them. Enter values and tap Run.

    Argument dialog for Follow service logs with the service field and RunArgument dialog for Follow service logs with the service field and Run

Running a snippet on several machines

  1. Tap the snippet on the Snippets tab. Run snippet opens.

  2. Choose machines. Tick one or more machines, then tap Run on 3 machine(s) (the number is how many you ticked).

    • Arguments are filled in once for all machines.
  3. View progress. Tap the play icon at the top of the Snippets tab to open the Runs screen.

    • Each machine shows a status: Waiting, Connecting, Running, Done, or Exit with the command’s exit code, such as Exit 1.
    • Tap a run to see its output. Use Copy output or Run again. Tap Clear to remove a run.

Something wrong or missing on this page?Tell us on the issue tracker.