desto 0.2.0

tmux session manager

desto lets you run and manage your bash and Python scripts in the background (inside tmux sessions) through a simple web dashboard. Launch scripts, monitor their and your system's status, view live logs, and control sessions—all from your browser.

---

The key features are:

• One-click session control: Start, monitor, and stop tmux sessions from your browser.
• 🐚 Bash & 🐍 Python support: Run both bash (.sh) and Python (.py) scripts seamlessly.
• Live system stats: See real-time CPU, memory, and disk usage at a glance.
• Script management: Use your existing scripts, write new ones, edit, save, or delete them directly in the dashboard.
• Script chaining: Queue multiple scripts to run sequentially in a single session.
• Scheduling: Schedule scripts or script chains to launch at a specific date and time.
• Live log viewer: Watch script output in real time and view logs for each session.
• Persistent storage: Scripts and logs are saved in dedicated folders for easy access.
• 🖥️ Command-line interface: Manage sessions, view logs, and control scripts from the terminal with our modern CLI. Learn more →

🎬 Demo

⚡ Quick Start

🐳 Quick Start with Docker

The easiest way to get started with desto is using Docker:

# Clone the repository
git clone https://github.com/kalfasyan/desto.git
cd desto

# Set up example scripts (optional - for testing)
make docker-setup-examples

# Build Docker image
docker build -t desto:latest .

# Use the example scripts (or your own scripts directory)
docker run -d -p 8088:8088 \
  -v $PWD/desto_scripts:/app/scripts \
  -v $PWD/desto_logs:/app/logs \
  --name desto-dashboard \
  desto:latest

🌐 Access the dashboard at: http://localhost:8088

Make sure your bash scripts are executable:

chmod +x /path/to/your/scripts/*.sh

---

✨ desto Overview

👀 Dashboard Overview

🚀 Launch your scripts as tmux sessions
When you start desto, it creates desto_scripts/ and desto_logs/ folders in your current directory. Want to use your own locations? Just change these in the settings, or set the DESTO_SCRIPTS_DIR and DESTO_LOGS_DIR environment variables.

Your scripts show up automatically—no setup needed. Both .sh (bash) and .py (Python) scripts are supported with automatic detection and appropriate execution. Ready to launch? Just:

1. Name your tmux session
2. Select one of your scripts
3. (OPTIONAL) edit and save your changes
4. Click "Launch"! 🎬

🟢 Keep Alive: Want your session to stay open after your script finishes? Just toggle the switch. This adds tail -f /dev/null at the end, so you can keep the session active and continue viewing logs, even after your script completes.

✍️ Write new scripts and save them

If you want to compose a new script, you can do it right here, or simply just paste the output of your favorite LLM :) Choose between bash and Python templates with syntax highlighting and smart defaults.

⚙️ Change settings

More settings to be added!

📜 View your script's logs

---

🛠️ Installation

🐳 Docker Installation (only dashboard)

Docker lets you run desto without installing anything on your computer. It provides a consistent environment across all platforms, making it the easiest way to get started.

Quick Docker Setup

See the Quick Start with Docker section above for a complete guide.

Docker Management

# View logs
docker logs -f desto-dashboard

# Stop the container
docker stop desto-dashboard

# Remove the container
docker rm desto-dashboard

# Rebuild after changes
docker build -t desto:latest . --no-cache
docker run -d -p 8088:8088 \
  -v $PWD/desto_scripts:/app/scripts \
  -v $PWD/desto_logs:/app/logs \
  --name desto-dashboard \
  desto:latest

# List all containers
docker ps -a

# List all images
docker images -a

# Remove all stopped containers
docker container prune

# Remove all unused images
docker image prune -a

# Remove the container and image
docker rm -f desto-dashboard
docker rmi desto:latest

🔧 Traditional Installation

Requirements

• Python 3.11+
• tmux
• at (for scheduling features)

Check pyproject.toml

Installation Steps

1. Install tmux and at

   Instructions for different package managers

   • Debian/Ubuntu

     sudo apt install tmux at
     

   • Almalinux/Fedora

     sudo dnf install tmux at
     

   • Arch Linux

     sudo pacman -S tmux at
     

   Note: The at package is required for scheduling features. If you don't plan to use script scheduling, you can skip installing at.

2. Install desto

   Installation Steps

   • With uv, simply run:

     uv add desto
     

     This will install desto in your project ✅ Or if you don't have a project yet, you can set up everything with uv:

     1. Install uv by following the instructions on the official site.

     2. Create and set up your project:

        mkdir myproject && cd myproject
        uv init
        uv venv
        source .venv/bin/activate
        uv add desto
        

        Done!

   • With pip:

     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).

🖥️ Command Line Interface

In addition to the web dashboard, desto includes a powerful CLI for managing tmux sessions from the terminal. Perfect for automation, scripting, or when you prefer the command line.

Installation as a uv Tool

# Install desto CLI globally
uv tool install desto

# Or install from source
cd /path/to/desto
uv tool install . --force

This installs two executables:

• desto - Web dashboard
• desto-cli - Command-line interface

Quick CLI Usage

# Check system status
desto-cli doctor

# Session Management
desto-cli sessions list

# Start a new session
desto-cli sessions start "my-task" "python my_script.py"

# View session logs
desto-cli sessions logs "my-task"

# Kill a session
desto-cli sessions kill "my-task"

# Script Management
desto-cli scripts list                     # List all scripts
desto-cli scripts create "my_script" --type python  # Create new script
desto-cli scripts edit "my_script"         # Edit script in $EDITOR  
desto-cli scripts run "my_script"          # Run script in tmux session
desto-cli scripts run "my_script" --direct # Run script directly

📖 Full CLI Documentation →

The CLI provides the same functionality as the web interface but optimized for terminal use, including rich formatting, real-time log viewing, and comprehensive session management.

---

License

Shield:

This work is licensed under a Creative Commons Attribution 4.0 International License.

---

TODO

• Explore possibility to pause processes running inside a session
• Add dark mode/theme toggle for the dashboard UI

---

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