Skip to content

"Startup snippets" tip describes a feature that doesn't exist (snippet as host Pre-command) #11

Description

@kipavy

Problem

docs/terminal/snippets.md:99 (the "Startup snippets" tip) claims:

Set a snippet as the Pre-command on a host (connection form → Advanced) to run it every time you connect.

This capability does not exist in the app today. The host Pre-command (and Post-command) fields accept only an inline command string, which is written verbatim to the shell — there is no snippet picker and no snippet resolution. Verified in the client:

  • ConnectionForm.tsx:567-583 — plain single-line inputs, no snippet reference
  • client.rs:892writer.write_all(format!("{}\n", cmd)) on connect
  • session.rs:242/256 — same for post_command on disconnect

So a reader following this tip cannot set a snippet there. (Also note: Post-command runs on disconnect, not connect.)

Options

  1. Correct the docs now — reword the tip so it reflects reality (a pre-command is an inline command line you type in; a one-liner from a snippet can be pasted, but snippets aren't selectable there).
  2. Keep as-is once the feature ships — the app-side feature request is tracked in Allow a snippet as host Pre/Post command (keep inline support); fix docs mismatch voltius#63 (allow a snippet as pre/post command while keeping inline). If/when that lands, this tip becomes accurate and the two should be closed together.

Recommend doing (1) in the interim regardless, so the published docs don't describe a missing feature.

Suggested interim wording

Startup commands — set a Pre-command on a host (connection form → Advanced) to run a command line every time you connect. (Running a full saved snippet here is tracked in voltius#63.)

Related: VoltiusApp/voltius#63

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions