Stop searching. Just ask your terminal. Local AI assistant that runs entirely on your machine — no cloud, no API, no setup friction.

⚡ Example

$ how do I list hidden files sorted by size

→ instantly returns:

ls -laSh

No browser. No copy/paste. No remembering flags.

🚀 Install

curl -fsSL https://raw.githubusercontent.com/deltaxmodules/tuxaide/main/setup.sh | bash

Then:

# Linux (bash)
source ~/.bashrc

# macOS (zsh)
source ~/.zshrc

Start typing questions directly in your terminal.

How it works

Write your Linux question directly in the terminal, as if it were a command:

$ how do I list hidden files sorted by size

TuxAide intercepts it silently and answers inline:

╭──────────────────────────────────────────────────────────────╮
╞═ 🐧 TuxAide (Ollama · qwen2.5-coder:7b · Smart RAG) ═╡

  To list hidden files sorted by size:

  ┄ shell ┄
  ls -laSh
  ┄┄┄┄┄┄┄

  -a shows hidden files, -S sorts by size (largest first),
  -h shows human-readable sizes (KB, MB, GB).
  To reverse: ls -laShr

  Source: man ls(1)

╰──────────────────────────────────────────────────────────────╯

Normal commands (ls -la, git commit, sudo apt update) pass through untouched. Zero interference.

Why TuxAide

1. No trigger word needed. You don’t type ask, hey or anything else. Just write your question — TuxAide hooks into the shell and responds.

2. It only explains. Never executes. Safer by design. You stay in control of what runs on your system.

3. 100% local by default. No API key. No account. No cloud. Nothing leaves your machine — ever.

4. Built for people learning Linux. No remembering flags. No searching docs. Just ask.

5. One command installs everything. Ollama, model, shell hook — all in one command.

6. Smart RAG — fast when simple, precise when needed. Simple questions → fast LLM answers Command-specific → local documentation (man pages)

Response speed (v2.1)

Any language

how do I check open ports
como listar ficheiros ocultos
comment lister les fichiers cachés
cómo ver el espacio en disco
wie zeige ich offene Ports

TuxAide automatically replies in your language.

Examples

how do I backup with rsync
why is my process consuming so much RAM
what is the difference between chmod and chown
how to configure cron to run at 3am
how to see who is connected via SSH
how to create a sudo user on Ubuntu
what does the -z flag do in grep

Destructive command warnings

⚠ WARNING: This command is destructive and irreversible. Verify carefully before running.

rm -rf /old-data/

Controls

tuxaide on
tuxaide off
tuxaide status
tuxaide model llama3.2

tuxaide mode smart
tuxaide mode deep
tuxaide mode llm

tuxaide --timing
tuxaide reindex
tuxaide index nginx

tuxaide-uninstall

🔒 Data Sovereignty

• Fully local processing via Ollama
• No external calls
• No tracking
• Works offline after install
• GDPR / NIS2 / Swiss nDSG friendly

Compatibility

Shells: bash, zsh RAM: 5GB minimum (8GB recommended)

Contributing

Open source project — contributions welcome.

👉 https://github.com/deltaxmodules/tuxaide