Many example commands in docs do not work

[pckilgore]

zsh:

$ sprite exec "python -m http.server 8080 &"
executable file python -m http.server 8080 & not found in $PATH: No such file or directory
Error: exit status 1

bash:
bash-5.2$ sprite exec "python -m http.server 8080 &"
executable file python -m http.server 8080 & not found in $PATH: No such file or directory
Error: exit status 1

[pckilgore]

bash-5.2$ sprite exec "node --version && python3 --version && go version"
executable file `node --version && python3 --version && go version` not found in $PATH: No such file or directory
Error: exit status 1

[pckilgore]

works:

bash-5.2$ sprite exec echo "Hello, Sprites!"
Hello, Sprites!

[pckilgore]

doesn't:

bash-5.2$ sprite exec "cd /tmp && ls -la"
executable file `/home/sprite/cd /tmp && ls -la` not found: No such file or directory
Error: exit status 1

[pckilgore]

@mrkurt are these docs just lazy AI written crap, is this a bug, or do you just not want people using this that can't figure out you gotta mentally add sh -c into all the examples?

[meredydd]

Additional examples: The SSHFS helper example script does not work for (at least!) two reasons:

1. sprite use has apparently changed so that it always pops up the TUI rather than emitting the current sprite's name, so the variable ends up being filled with verbose TUI output rather than a sprite name

2. ssh sprite@$sprite_name.sprites.dev does not work even once the name is correct. ssh -vvvv and telnet suggests the port is open for a few seconds then closes/RSTs.

   I don't know whether this was a feature that has been switched off since the docs were written, whether the docs have the SSH connection info wrong, or whether fly is currently having an outage. Based on the track record so far, all three are entirely plausible!

Seriously, I really want to love sprites, but having to fight the documentation every step of the way is just exhausting. (not detailing the other examples I had to overcome to get to this point as that would be off-topic for this issue.)

[kcmartin]

Fixed via #88 and #113

[kcmartin]

@meredydd and @pckilgore

Thanks for the detailed report — you're right on both counts.

1. sprite use TUI issue: The helper now requires an explicit name (spritemount my-sprite) instead of trying to capture output from sprite use.
2. Direct SSH doesn't work: Sprites don't expose SSH directly. The updated docs now show setting up an SSH server on the Sprite and tunneling through sprite proxy.

These fixes are in #88 . We've also fixed the sprite exec quoting issues from the original report in #113 .

Thanks for flagging these, Sprites is moving fast and we're working to keep the docs accurate.