feat: SSH Command from Files

[andrecalil]

Summary

Introduces a new source option for SSH commands: inline (current) or file.
This should offer a better UX for large commands.

Resolves #5344

[superplanehq-integration]

👋 Commands for maintainers:

• /sp start - Start an ephemeral machine (takes ~30s)
• /sp stop - Stop a running machine (auto-executed on pr close)

[superplane-gh-integration-9000]

Docs Impact Review

The SSH component reference will auto-update, but the Files concept page needs a new section explaining that user-defined scripts can be stored in the repository and referenced by components.

Suggested docs updates:

• docs/concepts/files (https://docs.superplane.com/concepts/files) — Add a new subsection (e.g. "Adding your own files" or "User files") to the "What's in the repository" section. Explain that beyond canvas.yaml and console.yaml, users can upload arbitrary files (e.g. shell scripts under scripts/) via the Files tab, and that components such as SSH Command can reference those files by path. The current table lists only the two system files, which will actively mislead users trying to configure "From file" mode for SSH.

Why: The PR introduces a new commandSource field on the SSH node with an "From file" option that reads a script from the app's git repository at publish and execution time. The component reference docs are auto-generated and will pick up the new fields automatically. However, the Files concept page currently states the repository contains only canvas.yaml and console.yaml — a user following the docs to set up file-backed SSH commands will find no guidance on how to add a script file to the repository, making the feature effectively undiscoverable from the docs.

---

Maintainers: Reply with /docs-agree to open a tracking issue in superplanehq/docs (and assign it to you), or /docs-reject to dismiss this check.

Posted automatically by warp-gateway · commit 434bbc3

[AleksandarCole]

/docs-agree

[superplane-gh-integration-9000]

Tracking docs update in superplanehq/docs#115: superplanehq/docs#115

Assigned @AleksandarCole.

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 948b78a. Configure here.}

[lucaspin]

Why are we storing the file contents in the node metadata?

[lucaspin]

What if when using a file, we actually copied that file into the host, and executed the file with bash? I'm guessing that would make the experience of using multi-line or full-on scripts a lot easier

[andrecalil]

Interesting. Addressing this now.