cleanup shell bootstrapping

- save a roundtrip
- ensure POSIX shell
- use timeout
- some documentation