🎈 fly-tui

A high-performance, developer-centric Terminal UI for managing Fly.io machines.

Built with Python and Textual, fly-tui provides an instant, real-time dashboard for your Fly.io infrastructure without leaving your terminal.

✨ Features

• 🚀 Instant Insights: Zero-config dashboard that auto-detects your Fly app.
• 📡 Real-time Monitoring: Configurable refresh intervals with live status indicators (●).
• 📝 Live Logs: Stream machine logs with full ANSI color support and mouse-drag selection.
• ⚡ Quick Controls: Start, stop, and restart machines with lightning-fast keybindings.
• 🐚 SSH Integration: Drop into an interactive SSH console instantly.
• ⚖️ Elastic Scaling: Scale machine counts and VM sizes via intuitive modal dialogs.
• 🎯 Cursor Stability: Intelligent data diffing ensures your selection never flickers during refreshes.

📦 Installation

Install as a global tool using uv:

uv tool install fly-tui

Or install from PyPI:

pip install fly-tui

🛠 Usage

Simply run ftui inside any directory containing a fly.toml:

ftui

Options

• --refresh <seconds>: Set a custom refresh interval (default: 5s).
• --mock: Explore the UI with simulated data (no Fly account required).

⌨️ Keybindings

Key	Action
r	Manual Refresh
l	View Logs
s	Scale App
h	SSH Console
Ctrl+s	Start Machine
Ctrl+x	Stop Machine
Ctrl+r	Restart Machine
q	Quit / Back

🤝 Contributing

Contributions are welcome! This project is built for the community. Feel free to open issues or PRs on GitHub.

📄 License

MIT © Fly.io Community