Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

46 Commits
 
 
 
 

Repository files navigation

DeamonCLI

An interactive Linux command reference with a built-in terminal.

Stop googling the same commands over and over. DeamonCLI lives in your system tray and lets you search for what you want to do in plain English — it finds the command, explains it, and runs it right there.

DeamonCLI logo


What it does

  • Search by intent — type "make sound louder", "scan my network", or "connect to server" and it finds the right command
  • 658 commands across 44 categories: Sound, WiFi, Files, SSH, Git, Security, AI & Ollama, Backup, VPN, Encryption, Virtualization, tmux, Shell Scripting, and more
  • Built-in terminal — run commands directly inside the app and keep working without switching windows
  • System tray icon — lives near your wifi/bluetooth icons; click to open or quit
  • Runs in the background — closing the window (X) keeps the app alive via tmux; click the tray icon to bring it back
  • Remembers your layout — window size and panel positions are saved between sessions
  • Command history — see everything you've run or copied, with timestamps

Install

Requirements

  • Linux (Ubuntu, Zorin OS, or any Debian-based distro)
  • Python 3.8+
  • gnome-terminal

One-command install

git clone https://github.com/sebamuhr/DeamonCLI.git
cd DeamonCLI
bash DeamonCLI/install.sh

The installer will:

  1. Install Python packages (textual, pyperclip)
  2. Install system packages: tmux, wmctrl, xclip, gnome-terminal, AppIndicator
  3. Copy app files to ~/.local/share/deamoncli/
  4. Create a launcher at ~/.local/bin/deamoncli
  5. Create a desktop shortcut and app menu entry
  6. Set the tray icon to start automatically on login
  7. Start the tray icon immediately

To uninstall: bash DeamonCLI/install.sh --uninstall


How to use

Opening the app

  • Click the daemon face icon in the system tray (near wifi/bluetooth)
  • Or double-click the desktop shortcut
  • Or search "DeamonCLI" in your apps menu
  • Or run deamoncli in a terminal

Closing and reopening

  • X button — hides the window, keeps the app running in the background via tmux
  • Tray icon → Open DeamonCLI — brings the window back (re-attaches to the running session)
  • Tray icon → Quit — fully closes everything, including any background jobs

Searching

Type anything in the search box — plain English works fine:

You type It finds
loud Make the sound louder
scan network Discover all devices on local network
connect server SSH commands
check who logged in Login history, failed attempts
encrypt file GPG encryption commands

Results appear instantly. Click any result to see the full explanation and command.

Running commands

Each command shows:

  • What it does — a plain English explanation
  • The command — exact syntax, ready to use
  • Run it — executes the command in the built-in terminal below
  • Copy — copies to clipboard so you can paste in your own terminal

Commands marked ⚠ require a real terminal (they need sudo or are interactive) — use Copy and paste them.

Built-in terminal

The bottom panel is a real terminal session. You can:

  • Run any command, not just ones from the database
  • Use cd to navigate folders — the prompt updates to show where you are
  • Chain commands, pipe output, do your work without leaving the app

Categories

Category Examples
Sound & Audio volume, mute, audio devices, PulseAudio
WiFi & Network IP address, connect to WiFi, download files
Display & Screen screenshots, brightness, monitor settings
Files & Folders find, copy, move, compress, permissions
Processes & System CPU, RAM, running processes, system info
SSH & Remote connect, copy files, tunnels, firewall
Cybersecurity nmap, tcpdump, GPG, openssl, fail2ban, lynis
Development Git, Python, Node, packages
Bluetooth pair, connect, scan devices
USB & Hardware list devices, temperatures, battery
Users & Security accounts, passwords, groups
Text & Files grep, sed, head, tail, sort
Package Management apt, snap, flatpak, dpkg
Disk & Storage df, du, mount, partitions, SMART
Containers & VMs Docker, Podman, VirtualBox
Systemd & Services start/stop services, journalctl, timers
Networking Tools ping, traceroute, netstat, nmap, DNS
Cryptography GPG, openssl, hashing, certificates
Forensics & Incident Response log analysis, file integrity, volatility
Web & API curl, wget, HTTP headers, APIs
Scripting & Automation cron, bash, variables, loops
Monitoring & Performance htop, iotop, vmstat, perf
Database CLI SQLite, MySQL, PostgreSQL
Cloud & DevOps AWS CLI, gcloud, kubectl, Terraform
AI & Ollama Ollama, Claude Code, Gemini CLI, Aider, Fabric, Shell-GPT, embeddings, RAG
Backup & Sync rsync, restic, BorgBackup, rclone, tar
VPN & Tunneling WireGuard, OpenVPN, SSH tunnels, SOCKS proxy
Encryption & LUKS LUKS, cryptsetup, age, GPG, shred
Filesystems & LVM btrfs snapshots, LVM, ext4, NTFS, fsck
Virtualization KVM/QEMU, libvirt/virsh, VirtualBox, QEMU
tmux sessions, windows, panes, scripting
Shell Scripting strict mode, functions, arrays, traps, debug
Web Servers Nginx, Apache, Certbot/Let's Encrypt, Caddy
Remote Desktop xRDP, TigerVNC, x11vnc, SSH tunnelling
Version Managers nvm, pyenv, SDKMAN, mise
Media & Video ffmpeg, yt-dlp, ImageMagick
PDF & Documents pdftk, Ghostscript, OCR, Pandoc
File Sharing Samba, NFS, SSHFS
Advanced Networking iptables, UFW, bridges, VLANs, iperf3, tcpdump
Text Processing awk, sed, xargs, sort, cut, tr
Hardware & Sensors lm-sensors, nvidia-smi, hdparm, SMART
Logs & Monitoring journalctl, logwatch, dmesg, auth logs
Flatpak, Snap & AppImage flatpak, snap, AppImage, Wine
jq & Data Tools jq, yq, csvkit, csvsql
Git Advanced stash, cherry-pick, rebase, bisect, worktree
Boot & GRUB grub-update, UEFI, systemd-boot, efibootmgr

Tech stack

  • Textual — Python TUI framework
  • tmux — keeps the app running when the window is closed
  • SQLite — search and command history
  • AppIndicator3 / AyatanaAppIndicator3 — system tray icon
  • GTK3 — tray menu
  • wmctrl — raises existing window instead of opening a duplicate

Files

DeamonCLI/
├── linux_ref.py        # Main app (Textual TUI)
├── commands_db.json    # All 658 commands across 44 categories
├── tray.py             # System tray daemon
├── launch.sh           # Smart launcher (tmux, geometry, tray)
├── install.sh          # Installer / uninstaller
└── DeamonCLI_logo.png  # App icon

Config is stored at ~/.config/deamoncli/config.json (window size, panel layout).

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages