tuxmate-cli 1.0.1

CLI tool for installing Linux packages using tuxmate's curated database

TuxMate CLI

THE TUXMATE COMPANION FOR YOUR TERMINAL

The CLI-Mate you need for your linux setup

A command-line interface for installing Linux packages using tuxmate's curated package database. Perfect for setting up a fresh Linux system or bulk-installing your favorite apps.

Features

# List and search packages
tuxmate-cli list
tuxmate-cli search firefox

# Install packages directly
tuxmate-cli install firefox neovim git

# Generate install scripts
tuxmate-cli oneliner vscode spotify

• 150+ curated packages across browsers, dev tools, terminals, media, and more
• Multi-distro support - Ubuntu, Debian, Arch (AUR), Fedora, openSUSE, Nix, Flatpak, Snap
• Smart script generation - Distro-specific scripts with error handling
• Always updated - Syncs with tuxmate's latest package data

See Usage section below for detailed commands.

Installation

pip install tuxmate-cli --upgrade

Usage

List available packages

tuxmate-cli list
tuxmate-cli list --category "Dev: Editors"
tuxmate-cli list --distro arch

Search packages

tuxmate-cli search firefox
tuxmate-cli search editor --distro ubuntu

Get package info

tuxmate-cli info neovim
tuxmate-cli info vscode

Install packages

# Install directly
tuxmate-cli install firefox neovim git

# With Flatpak fallbacks
tuxmate-cli install vscode spotify --flatpak

# Dry run (show script without executing)
tuxmate-cli install firefox --dry-run

# Save script to file
tuxmate-cli install firefox neovim -o install.sh

Generate scripts

# One-liner command
tuxmate-cli oneliner firefox neovim git

# Full script to stdout (pipe to bash)
tuxmate-cli script firefox neovim | bash

# Save to file
tuxmate-cli script firefox neovim > install.sh

Other commands

# Update package database
tuxmate-cli update

# List categories
tuxmate-cli categories

# List supported distros
tuxmate-cli distros

Requirements

• Python 3.10+ with pip
• uv (recommended) or standard pip/venv
• Git - For cloning the repository

Development

git clone https://github.com/Gururagavendra/tuxmate-cli.git
cd tuxmate-cli
uv sync
uv run tuxmate-cli --help

Security

• Trusted Source: Package data is fetched from tuxmate.com
• Script Review: Use --dry-run to review commands before execution
• Sudo Required: Installations require root privileges - review scripts carefully
• Sandboxing: JavaScript data parsing is sandboxed via dukpy

For technical details, see ARCHITECTURE.md.

Supported Distributions & Packages

For the complete list of supported distributions and package catalog, visit tuxmate.com

Future Integration

tuxmate-cli is designed to integrate with TuxSync (coming soon), a profile sync tool for Linux configurations. TuxSync will use tuxmate-cli to restore your application list across machines.

# TuxSync uses tuxmate-cli for package restoration
tuxsync restore --source github:user/gist-id

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

GPL-3.0 License - see LICENSE for details.

Credits

• Package database from tuxmate by @abusoww
• Built with Click and Rich