linux-commands-guide — lh

Bilingual ES/EN Linux command reference for the terminal. 51 tools covered, keyword search across all of them, one short command: lh. Like a cheat sheet that is always one keystroke away — and works over SSH.

Guía de comandos Linux bilingüe (español / inglés) para la terminal.

✨ Features

• 🌐 Bilingual — Spanish or English, picked from your locale (--lang es|en to force it)
• 🔍 Cross-tool search — lh -s port finds every command mentioning "port", in both languages
• 📦 51 tools — awk, grep, find, git, docker, ssh, tmux, jq, ss, rsync, tar, systemctl, iptables and more
• ✅ Checked content — every entry is tested for both translations; examples are real, working commands
• 🔇 Pipe-friendly — plain text when piped (lh tar | less), honours NO_COLOR

📥 Installation

pip install linux-commands-guide

Or from source:

git clone https://github.com/serber1990/linux-commands-guide.git
cd linux-commands-guide
pip install -e .

🛠 Usage

lh <tool>                  # Show commands for a tool
lh -s <keyword>            # Search across all tools
lh --lang en <tool>        # Force English (or --lang es for Spanish)
lh --help                  # Help and the full tool list
lh --version

Examples

lh ssh

  ╔══════════════════════════════════════════════╗
  ║  SSH Options                                 ║
  ╚══════════════════════════════════════════════╝

  Command                                             Description
  ──────────────────────────────────────────────────────────────────────────────────────────────
  ssh user@host                                       Connect to host as the given user
  ssh -p <port> user@host                             Connect using the specified port
  ssh -i key.pem user@host                            Use a private key for authentication
  ssh -L 8080:localhost:80 user@host                  Local tunnel: forward local port 8080 to host port 80
  ssh -R 9090:localhost:8080 user@host                Remote tunnel: forward host port 9090 to local port 8080
  …

lh -s port

  ╔══════════════════════════════════════════════════╗
  ║  Search: port                                    ║
  ╚══════════════════════════════════════════════════╝

  34 results

  ▶  docker
    docker run -p 8080:80 image_name
    Map host port to container port
  ▶  firewall-cmd
    firewall-cmd --zone=zone --add-port=80/tcp --permanent
    Permanently open TCP port 80
    firewall-cmd --zone=zone --remove-port=80/tcp --permanent
  …

🔧 Available Tools

🧪 Development

pip install -e ".[dev]"
ruff check .
pytest

Each tool is a small module in guia_linux/tools/ with a COMMANDS list. To add one, copy an existing module, register it in guia_linux/tools/__init__.py, add it to the table above, and run pytest — the test suite checks that every entry has both translations and that the README lists every tool.

See CHANGELOG.md for release notes.

📝 License

MIT — see LICENSE.

💬 Feedback

Open an issue or reach out via GitHub.

🌐 Connect