desto 0.1.3

tmux session manager

desto

!

desto is a modern, intuitive dashboard for managing and monitoring your tmux sessions. It provides a user-friendly web interface to start, view, and kill tmux sessions, monitor system stats, run custom or predefined scripts, and view live logs—all from your browser.

---

Features

• Session Management: Start, view, and kill tmux sessions with a single click.
• System Monitoring: Real-time CPU, memory, and disk usage stats in the sidebar.
• Templates & Custom Scripts: View predefined templates (like recursive pattern search) or write your own bash scripts directly in the browser.
• Keep Alive Option: Optionally keep sessions running after your script finishes.
• Live Log Viewer: View live logs for each session in a scrollable, syntax-highlighted interface.
• Responsive UI: Clean, modern interface built with NiceGUI.
• Persistent Logs & Scripts: All logs and scripts are stored in dedicated folders for easy access and reproducibility.

---

TODO

• Explore possibility to pause processes running inside a session
• Make it more intuitive to export/import custom templates/scripts
• Add dark mode/theme toggle for the dashboard UI
• Implement notifications for session completion or errors

---

Functionality

Dashboard Overview

Write new scripts and save them

Check some pre-defined templates
(soon users will be able to save their own)

Change settings

View your script's logs

---

Quick Start

1. Install tmux

   Instructions for different package managers

   • Debian/Ubuntu

     sudo apt install tmux
     

   • Almalinux/Fedora

     sudo dnf install tmux
     

   • Arch Linux

     sudo pacman -S tmux
     

2. Install desto

   Installation Steps

   • With uv:

     uv add desto
     

   • With pip:

     pip install desto
     # or
     uv pip install desto
     

3. Run the Application

   desto
   

4. Open in your browser
   After starting, visit http://localhost:8088 (or the address shown in your terminal).

---

Requirements

• Python 3.11+
• tmux
• NiceGUI

---

License

MIT License

---

desto makes handling tmux sessions approachable for everyone—no terminal gymnastics required!