Package Exports

@leverageaiapps/gogogo
@leverageaiapps/gogogo/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@leverageaiapps/gogogo) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

GoGoGo

CLI tool to forward terminal sessions to your mobile device via Cloudflare Tunnel. Code anywhere from your pocket.

Features

Zero Config - One command to start; cloudflared is downloaded automatically
Mobile Access - Access your terminal from any device with a browser
Secure - Cryptographic token auth with httpOnly cookies
No Port Forwarding - Uses Cloudflare Quick Tunnel (no account needed)
Real-time - WebSocket-based communication for instant feedback
PTY Support - Full terminal emulation with node-pty
Image Paste - Paste images from clipboard to upload file paths

Installation

npm install -g @leverageaiapps/gogogo

Verify Installation:

gogogo --version

Quick Start

# Start a terminal session
gogogo start

# Start with a specific command
gogogo start claude
gogogo start python
gogogo start vim

A QR code will appear - scan it with your phone to access your terminal. Authentication is automatic via a secure token embedded in the URL.

Usage

Basic Commands

# Start a terminal session (opens your default shell)
gogogo start

# Start with a machine name
gogogo start --name "My Laptop"

# Start a specific command
gogogo start claude
gogogo start "claude --dangerously-skip-permissions"

Options

Option	Short	Description
`--name <name>`	`-n`	Set a custom machine name (default: hostname)
`--version`	`-V`	Show version number
`--help`	`-h`	Show help

How It Works

Run gogogo start [command] in your terminal
GoGoGo starts a local web server and creates a Cloudflare tunnel
A QR code appears with your unique, authenticated URL
Scan the QR code with your phone
Your terminal is now accessible from your mobile device!

Exiting

To exit GoGoGo, you can:

Type exit in the terminal (or the command to exit your current program)
Press Ctrl+C in the terminal where you ran gogogo start
Close the terminal window

When you see "Terminal session ended.", the session has been successfully closed.

Security

Token Authentication - Each session gets a unique 128-bit cryptographic token
httpOnly Cookies - Token is stored as a secure, httpOnly cookie after first visit
WebSocket Auth - WebSocket connections are verified via cookie
Connection Limits - Max 10 concurrent WebSocket connections
Rate Limiting - Message rate limiting per connection
Security Headers - CSP, HSTS, X-Frame-Options, and more

Troubleshooting

Error: posix_spawnp failed

Fix permissions on the node-pty spawn-helper:

# macOS ARM (M1/M2/M3)
chmod +x node_modules/node-pty/prebuilds/darwin-arm64/spawn-helper

# macOS Intel
chmod +x node_modules/node-pty/prebuilds/darwin-x64/spawn-helper

# Linux x64
chmod +x node_modules/node-pty/prebuilds/linux-x64/spawn-helper

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Cloudflare Tunnel for secure tunneling
node-pty for PTY support
xterm.js for terminal emulation in the browser