shell-now

README

Shell Now 🐚⚡

Instant Web Terminal via ttyd + cloudflared — A one-click webshell for developers, educators, and hackers.

ShellNow is a tiny Go-powered CLI tool that helps you instantly start a temporary, publicly-accessible web terminal using ttyd and Cloudflare Quick Tunnels.

Ideal for quick debugging, remote terminal sharing, and Linux teaching demos.

✨ Features

• 🚀 One command to launch a public web shell
• 🧩 Automatically downloads ttyd and cloudflared (cross-platform)
• 🔐 Optional password authentication
• 💻 Runs any shell or custom command (e.g. htop, matrix, bash)

📦 Usage / Installation

Coming soon: prebuilt binaries for macOS, Linux, Windows, ARM64

With docker:

docker run cr.strrl.dev/strrl/shell-now:latest

📚 Why?

Sometimes you just want to…

• 🔧 Show a live bug in a terminal to a teammate
• 👨‍🏫 Give a quick Linux/DevOps lesson via browser
• 🧪 Share a terminal-based demo of your CLI tool
• 🏠 Remotely connect to your own Pi/NAS with no public IP setup

ShellNow makes it dead-simple.

⚠️ Warning

This tool exposes your local shell to the public internet.

• ALWAYS Use password protection
• Prefer read-only demos when possible
• Avoid running this on sensitive systems

🙌 Contributing

Pull requests, issues, and ideas are welcome!