sudo-gera/free-vps — reverse-engineered prompt

Build me a small shell based project that gives me a temporary free Linux server I can reach over SSH, ideally by starting it from a CI run so I do not need to rent a VPS.

I want it to spin up a remote session, keep it alive, and print clear connection details so I can log in with my SSH key. If direct inbound SSH is tricky, set up whatever tunnel or forwarding is needed so port 22 is reachable in a practical way. Include a simple script I can run locally, plus the CI entry point, and make the flow easy to follow for someone who is not deep into infra.

Please keep it lightweight and script driven. Add basic setup for authorized keys, a way to publish the SSH endpoint, and any helper pieces needed to route traffic. Also include a short README with how to start it, how to connect, and the main limitations of using a temporary free machine. If you need details, check current docs online.