Built with Rust + GTK4

One window for
your dev environment

Processes, AI agents, SSH, and terminals — managed together. A native Linux desktop app for the way you actually work.

Get Started View on GitHub
MIT licensed Linux only Open source

Capabilities

Everything in one place

Stop juggling terminal tabs and tmux panes. TuxFlow gives you a unified view of everything running in your project.

Process Management

Start, stop, and restart dev servers and background tasks. Each process gets a real terminal with full ANSI colors.

AI Agents

Run Claude Code, Codex, Gemini CLI, OpenCode, and other agents side-by-side with the rest of your stack.

Agent Idle Alerts

Notified the moment an agent finishes its turn — terminal BEL detection plus an optional silence-based fallback, with per-agent sounds.

Auto-Restart

Crashed processes restart with exponential backoff. Stops after repeated failures so you can fix the root cause.

File Watching

Restart processes when source files change. Glob patterns let you scope watches to exactly what matters.

Multi-Project

Open multiple projects in one window with expandable sidebar sections, drag-and-drop reordering, and running-project highlights.

SSH Connections

Connect to remote hosts straight from ~/.ssh/config. Auto-restart handles reconnection like any other process.

Embedded Terminals

Full VTE4 terminals with true color, mouse events, search, clickable URLs, and configurable color schemes.

Command Palette

Ctrl+Shift+P to fuzzy-search every action, process, and project. Keyboard-first by design.

Stack Detection

Auto-detects Node.js, Rust, Go, Python, PHP, Docker and suggests sensible default commands to get you running fast.

Git Integration

Status, diff, commit, push, and pull from a built-in dialog. Live ahead/behind indicators and current branch in the status bar.

Resource Monitoring

Per-process CPU and memory via /proc, aggregated across child process trees. See what's eating your laptop at a glance.

Port & URL Detection

Smart detection scans terminal output for ports and URLs and ignores build-tool noise. Ctrl+click to open.

MCP Server

Unix socket API so AI agents can list processes, read terminal logs, and start/stop/restart your environment.

Notifications

Per-project title and icon, focus-aware suppression, and bundled notification sounds with picker and preview.

Theming

Dark, light, and system themes with accent colors, terminal color schemes, and font size controls.

Session Restore

Window position, open projects, and process order persist across sessions. Pick up exactly where you left off.

TOML Config

Optional tuxflow.toml in your project root. Simple, human-readable, and version-controllable.


Getting started

Install TuxFlow

Pick the method that fits your distro. Pre-built binaries for x86_64 Linux ship with every release.

shell
# Download the latest .deb from GitHub Releases
sudo dpkg -i tuxflow_*_amd64.deb
sudo apt-get install -f

Grab the latest .deb from GitHub Releases.

shell
# Download the latest .tar.gz from GitHub Releases
tar xzf tuxflow-*-x86_64-linux.tar.gz
cd tuxflow-*-x86_64-linux
./install.sh              # installs to /usr/local (requires sudo)
./install.sh --user       # installs to ~/.local (no sudo)

Grab the latest .tar.gz from GitHub Releases.

shell
# Ubuntu/Debian
sudo apt install libgtk-4-dev libadwaita-1-dev libvte-2.91-gtk4-dev build-essential

# Fedora
sudo dnf install gtk4-devel libadwaita-devel vte291-gtk4-devel gcc

# Arch
sudo pacman -S gtk4 libadwaita vte4

git clone https://github.com/markovic-nikola/tuxflow.git
cd tuxflow
cargo build --release
./target/release/tuxflow

Navigation

Keyboard-driven

TuxFlow is built to keep your hands on the keyboard. Every shortcut is configurable in Settings.

Ctrl+Shift+PCommand palette
Ctrl+NAdd project / process
Ctrl+TNew terminal
Ctrl+,Settings
Ctrl+FFilter processes
Ctrl+Shift+FTerminal search
Ctrl+GQuick jump
Ctrl+WClose agent / terminal
Ctrl+\Toggle sidebar
Ctrl+/Prev / Next process
Ctrl+Shift+/Prev / Next project
Ctrl+/Focus sidebar / terminal
Ctrl+Alt+SStart / Stop process
Ctrl+Alt+RRestart process
Ctrl+Alt+CClear output
Ctrl+=/-Increase / Decrease font
Ctrl+Shift+C/VCopy / Paste
Ctrl+EnterCommit (in git dialog)

Integration

Built for AI agents

An MCP server over a Unix socket lets AI agents observe and control your dev environment without leaving the terminal.

Claude Code config

~/.config/claude-code/mcp.json
{
  "mcpServers": {
    "tuxflow": {
      "command": "tuxflow-mcp",
      "args": ["my-project"]
    }
  }
}

Ready to streamline your workflow?

TuxFlow is open source and MIT licensed. Try it on your next project.

Install Now Star on GitHub