plain-portal

Installation
SKILL.md

Remote Portal Session

Open an encrypted tunnel to a remote machine and run Python code on it.

1. Start the remote side and connect

The remote side must be running first. Either start it yourself (if you have access to the platform CLI) or ask the user to start it:

Platform Command
Heroku heroku run plain portal start
Fly.io fly ssh console -C "plain portal start"
Kubernetes kubectl exec -it deploy/app -- plain portal start
Docker docker exec -it container plain portal start
SSH ssh server plain portal start

Both start and connect are long-running foreground processes. If you run start yourself, use run_in_background so you don't block. Once it prints a portal code (e.g. 7-crossword-pineapple), read the code from the output. If the user ran it, ask them for the code.

Then connect (also use run_in_background):

Installs
1
Repository
dropseed/plain
GitHub Stars
1.0K
First Seen
May 16, 2026
plain-portal — dropseed/plain