ezshell 0.2.0__py3-none-any.whl

ezshell-0.2.0.dist-info/METADATA

@@ -0,0 +1,174 @@
+Metadata-Version: 2.4
+Name: ezshell
+Version: 0.2.0
+Summary: Terminal assistant: explains failed commands and suggests a fix you review before running
+Author: Salomon
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: groq>=0.11.0
+Requires-Dist: prompt_toolkit>=3.0.40
+Requires-Dist: rich>=13.7.0
+Requires-Dist: pyte>=0.8.2
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: textual>=8.0.0
+Requires-Dist: customtkinter>=6.0.0
+Requires-Dist: pillow>=10.0.0
+Requires-Dist: pydantic>=2.5
+Dynamic: license-file
+
+<div align="center">
+
+# ezShell
+
+**Ton terminal t'explique ses erreurs.**
+Une commande échoue ? `Alt+E` explique la cause et place une correction dans ton prompt. Tu relis, tu valides : rien n'est exécuté sans toi.
+
+![Python](https://img.shields.io/badge/python-3.10%2B-blue)
+![Licence](https://img.shields.io/badge/licence-MIT-green)
+![Version](https://img.shields.io/badge/version-0.2.0-orange)
+
+[Site](https://ezshell.vercel.app) · [Fonctionnalités](#fonctionnalités) · [Installation](#installation) · [Utilisation](#utilisation) · [Licence](#licence)
+
+<img src="docs/preview.webp" alt="Aperçu d'ezShell : après « npm run dev » qui échoue avec « vite: command not found », le panneau ezShell explique que vite n'est pas installé et propose la commande npm install -D vite" width="860">
+
+</div>
+
+---
+
+## Fonctionnalités
+
+- **Diagnostic de la dernière erreur** : la cause probable, en français ou en anglais selon ta locale.
+- **Correction insérée dans le prompt** : la commande arrive dans ta ligne de saisie ; c'est toi qui appuies sur Entrée.
+- **Langage naturel** : tape ta demande (« lister les ports ouverts ») puis `Alt+E` pour obtenir la commande.
+- **Niveau de risque** : faible, moyen ou élevé. Les règles locales d'ezShell relèvent le niveau si le modèle le sous-estime, et une commande à risque élevé exige une confirmation explicite (`y`).
+- **Sans clé API** : ezShell passe par son service hébergé ; ton appareil reçoit un jeton anonyme avec un quota quotidien gratuit.
+- **Secrets masqués** : mots de passe, clés API, jetons, identifiants dans les URL et clés privées sont masqués avant l'envoi, puis une seconde fois sur le serveur.
+- **bash, zsh et fish** sur Linux et macOS, **PowerShell** sur Windows (bêta). Une fenêtre de bureau et une interface plein terminal sont aussi disponibles.
+
+---
+
+## Installation
+
+Prérequis : Python 3.10 ou plus récent.
+
+```bash
+pipx install ezshell
+```
+
+Puis branche ezShell sur ton shell, en ajoutant la ligne correspondante à la fin de ton fichier de configuration :
+
+| Shell | Fichier | Ligne |
+|---|---|---|
+| zsh | `~/.zshrc` | `eval "$(ezsh init zsh)"` |
+| bash | `~/.bashrc` | `eval "$(ezsh init bash)"` |
+| fish | `~/.config/fish/config.fish` | `ezsh init fish \| source` |
+| PowerShell (Windows) | `$PROFILE` | `Invoke-Expression (& ezsh init powershell \| Out-String)` |
+
+Pour bash, zsh et PowerShell, `ezsh init --install` ajoute la ligne à ta place. Ouvre ensuite un nouveau terminal.
+
+**Windows (bêta) :** installe Python 3.10+ et [pipx](https://pipx.pypa.io/stable/), puis la même commande `pipx install` dans PowerShell (5.1 ou 7, avec PSReadLine). Si PowerShell refuse de charger ton profil, autorise les scripts locaux pour ton compte : `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`. Sous WSL, suis simplement les instructions Linux.
+
+**Mettre à jour :** lance `ezsh --update`. ezShell affiche les nouveautés, te demande confirmation (réponse par défaut : non), puis met à jour. Ajoute `--yes` pour passer la confirmation dans un script. Quand une nouvelle version existe, une ligne discrète te le rappelle au plus une fois par jour ; `EZSH_NO_UPDATE_CHECK=1` la désactive. Sous Windows, la commande à lancer dans un nouveau terminal t'est affichée (un programme ne peut pas se remplacer pendant qu'il tourne). Si tu as installé ezShell depuis l'URL git avant la version 0.2.0, réinstalle une dernière fois : `pipx install --force ezshell`.
+
+<details>
+<summary>Autres méthodes d'installation</summary>
+
+**Dernière version de développement** (pas encore publiée sur PyPI) : `pipx install git+https://github.com/Waddle-io/ezShell.git`
+
+**Installateur en une ligne** (installe dans `~/.local/share/ezshell`, commandes dans `~/.local/bin`) :
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/Waddle-io/ezShell/main/install.sh | bash
+```
+
+**Depuis les sources :**
+
+```bash
+git clone https://github.com/Waddle-io/ezShell.git
+cd ezShell
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e .
+```
+
+La fenêtre de bureau nécessite Tk (`sudo apt install python3-tk` sur Debian/Ubuntu).
+</details>
+
+Désinstaller : retire la ligne `ezsh init` de ton fichier de configuration, puis `pipx uninstall ezshell`.
+
+---
+
+## Utilisation
+
+### Dans ton terminal (`Alt+E`)
+
+Lance une commande qui échoue (par exemple `git psuh`), puis appuie sur `Alt+E`.
+
+| Touche | Action |
+|---|---|
+| `Entrée` | Insérer la commande dans le prompt (risque faible ou moyen) |
+| `y` | Insérer une commande à risque élevé ou sur plusieurs lignes |
+| `e` | Modifier la commande avant de l'insérer |
+| `c` | Copier dans le presse-papiers |
+| `/` | Poser une autre question |
+| `q` / `Échap` | Fermer sans rien insérer |
+
+Pour un diagnostic plus précis, lance la commande via `ezsh run` : la fin de sa sortie d'erreur est gardée (et masquée) pour l'analyse.
+
+```bash
+ezsh run -- npm run build
+```
+
+`ezsh suggest --ask "trouver les fichiers de plus de 1 Go"` ouvre le même panneau sans raccourci.
+
+### Autres modes
+
+```bash
+ezsh                 # fenêtre de bureau (interface terminal si aucun affichage)
+ezsh --tui           # interface plein terminal, pratique en SSH
+ezsh --explain "docker: Error response from daemon: port is already allocated"
+ezsh --check-key     # vérifie que le service ezShell répond
+ezsh --version
+```
+
+`ezsh --help` liste toutes les options.
+
+### Configuration
+
+Aucune configuration n'est nécessaire. Variables utiles :
+
+| Variable | Rôle |
+|---|---|
+| `EZSHELL_LANG` | Force la langue (`fr` ou `en`) ; sinon déduite de `$LANG` |
+| `EZSH_API_URL` | URL du service (défaut : `https://ezshell.vercel.app`) |
+| `EZSH_DIRECT=1` | Appelle Groq directement avec ta propre clé (`GROQ_API_KEY` ou `ezsh --set-key`) |
+| `EZSH_MODEL` | Modèle en mode direct (défaut : `openai/gpt-oss-120b`) |
+| `EZSH_STATE_DIR` | Dossier d'état par terminal (défaut : `$XDG_RUNTIME_DIR/ezsh`, `%LOCALAPPDATA%\ezsh` sous Windows) |
+| `EZSH_MOCK_LLM=1` | Simule le modèle, sans réseau (développement) |
+
+---
+
+## Confidentialité
+
+Rien n'est envoyé tant que tu n'appuies pas sur `Alt+E`. Sont alors envoyés : ton OS et ton shell, le dossier courant (avec `~` à la place de ton nom), la dernière commande, son code de sortie et, si tu passes par `ezsh run`, la fin de sa sortie d'erreur (4 Ko max). Le service ne conserve pas le contenu des requêtes : seulement un jeton d'appareil haché et des compteurs de quota.
+
+---
+
+## Développement
+
+```bash
+pip install -e . -r requirements-dev.txt
+pytest
+ruff check src tests
+EZSH_MOCK_LLM=1 ezsh suggest --ask "lister les gros fichiers"
+```
+
+Le service hébergé (Next.js + Postgres) est dans [`web/`](web/README.md). Voir aussi [`CONTRIBUTING.md`](CONTRIBUTING.md) et [`DEVELOPMENT.md`](DEVELOPMENT.md).
+
+---
+
+## Licence
+
+Distribué sous licence [MIT](LICENSE). © 2026 Salomon.

ezshell-0.2.0.dist-info/RECORD

@@ -0,0 +1,37 @@
+ezshell-0.2.0.dist-info/licenses/LICENSE,sha256=rJwmH6Oshoq2zSpsApfNxIrviaxdUznrORLXWmmyiyk,1068
+src/__init__.py,sha256=iVWzzlVkw7bRh-LeQzDbq8UTa0Sm40bqjOCL-VxyuCw,125
+src/app.py,sha256=TKk8y4727qvz1bLn1oYKv5WxSdAIC60BalvxGk58jyE,10910
+src/i18n.py,sha256=tTANnFhuzWFfN5HF6FhkQR8zjZEpn3QF9tGdaX_qBo0,13253
+src/main.py,sha256=od9jtsTwa3-Vcbme_YInfgzOwfRpq2tvsnJt3Bxtntk,11273
+src/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+src/core/assistant.py,sha256=YGRRN_vk0PQvnW1UvQzVlt6dzVRt8wRDWW0IRF90ljQ,21295
+src/core/capture.py,sha256=3dBnOYrPIjwLJAyn-isCUHf9aqtxjVkOtPyZiGCexvg,7221
+src/core/chat_bridge.py,sha256=Iiz4qIn_7XY25RsRci4KLiHox2onQmN88PvwKihPUXc,3798
+src/core/config.py,sha256=I27XP0W_V_uGVNW6tv3F-Sc66r__sU1YQJS4xs6c92c,9826
+src/core/context.py,sha256=wI2n317cNptzXXGoFe-w_iDHuYrtkY23PDdjyqPruB0,7235
+src/core/groq_client.py,sha256=ppodCJWHPaEEBy2tUgdzSTZWndLHh_lDijC173eIm8g,15258
+src/core/llm_client.py,sha256=Bd0wwHoK_nLeJal6NI4wKmH0Vdmqz4R8vVel5WohIFE,3275
+src/core/prompts.py,sha256=MrX0_t4fOK15_l1eu8usfbGKeK-GbKny7ZrtQ7HxCfo,11519
+src/core/provider.py,sha256=NHsNjZfIUhnkdfh0cc1vfhfzM7a6YKWOS3rvaknOKH8,8431
+src/core/proxy_client.py,sha256=00L8gswliny7b-DBLBBazuBuhxAO1G0ESZ3uXpArEZI,6804
+src/core/pty_shell.py,sha256=SWQGqYxsLGHdRHyPkJ0YuWa4WsJD8DEfWTpVYpbYato,8352
+src/core/redact.py,sha256=SJXMzCl47o1EuwsYWMLHoABJNNNdvpYsdAIGL1pYyvU,4232
+src/core/risk.py,sha256=xdLzblYnHKSvO0k5J2AYpALjSKO2W9O9n-io7pyblZg,14809
+src/core/safety.py,sha256=6jyX-A4i-mwU-4Z8g4Vg-tMOYn2iIVzWs-_5qsf8384,11355
+src/core/sanitize.py,sha256=jEOc5vmb55IbfLC4zk_zx7oWCRbGxqxO93KDXrRXe58,1404
+src/core/schema.py,sha256=Gg1Evw9wTectI4RzbOArOFydm2oEaYhCqLJzhUI_ifc,2049
+src/core/shell_hook.py,sha256=6OlNeIfm0HFyKdHctm54Rllus6X8E4QSOgPhTRYX6QY,15400
+src/core/suggest.py,sha256=6GkqrzymH1lrVqs9NnmJ2nUPkRt82ICS_xTVBCBV11w,3155
+src/core/updater.py,sha256=97ymdYieE8oIH5t4obJ8A8-qvbi2bjSH5mBogYePoWk,16961
+src/ui/chat_tui.py,sha256=QrWYC76dxQpbMGemoDiT7zVfSjHXxqZUIzxCz6qKyAU,20116
+src/ui/gui_window.py,sha256=3MfaEPTM3h710hD-CiuxrRCzP3S0jCmyx2QUyVRsGCI,38987
+src/ui/inline.py,sha256=GZI_JyfSylpQf3y6HHUqfG27D0wGrFzX8NwTR4hiRfE,11076
+src/ui/logo.py,sha256=OnljST95cm73CDvwNGSrKR4b3Do6oRhk_BunmSter-c,7655
+src/ui/panel.py,sha256=J8sR5y5ir8XC2TCTq9w_KZUCddPolaar3r1Z_rbUm6A,7509
+src/ui/prompt.py,sha256=fpoHoGRIFjW3HWIPFbjeNnpRZyiExm0m6vkEu82qAso,5529
+src/ui/render.py,sha256=J_IoWssbeBlwpPv3sHeJbBWyodXN1V2bzpI5K_dL4pE,9092
+ezshell-0.2.0.dist-info/METADATA,sha256=Q64N6GiYSfVDl3LUpdaJqXYSybgw-vPeTD4NeSxobeo,7449
+ezshell-0.2.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+ezshell-0.2.0.dist-info/entry_points.txt,sha256=gP6RfCPZAXVSYoTeIHSCkHecWjQqnKkPyxixomyAmzc,63
+ezshell-0.2.0.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+ezshell-0.2.0.dist-info/RECORD,,

ezshell-0.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ezshell-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+ezsh = src.main:main
+ezshell = src.main:main

ezshell-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 waddle Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ezshell-0.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+src

src/__init__.py

@@ -0,0 +1,3 @@
+"""ezShell. `__version__` est l'UNIQUE source du numéro de version (pyproject.toml le lit d'ici)."""
+
+__version__ = "0.2.0"

src/app.py

@@ -0,0 +1,286 @@
+from __future__ import annotations
+
+import os
+from pathlib import Path
+from typing import List, Optional
+
+from rich.panel import Panel
+
+from src.core.assistant import ShellAssistant
+from src.core.config import EzShellConfig
+from src.core.context import CommandHistoryEntry, SystemContext
+from src.core.pty_shell import PTYExecutor
+from src.ui.prompt import create_prompt_session, get_prompt_text
+from src.ui.render import (
+    console,
+    prompt_fix_action,
+    render_api_key_missing_card,
+    render_ask_card,
+    render_banner,
+    render_error,
+    render_error_card,
+    render_info,
+    render_success,
+)
+
+
+class EzShellApp:
+    """Main application orchestrator for ezShell interactive sessions."""
+
+    def __init__(self, config: Optional[EzShellConfig] = None):
+        self.config = config or EzShellConfig.load()
+        self.assistant: Optional[ShellAssistant] = None
+        self.history_entries: List[CommandHistoryEntry] = []
+        self.last_exit_code: int = 0
+        self.last_suggested_fix: Optional[str] = None
+
+        if self.config.get_effective_api_key():
+            self.assistant = ShellAssistant(config=self.config)
+
+    def _handle_cd(self, args: List[str]) -> int:
+        """Handles the 'cd' builtin command so directory changes persist."""
+        target = args[0] if args else str(Path.home())
+        if target == "~":
+            target = str(Path.home())
+        elif target == "-":
+            target = os.environ.get("OLDPWD", str(Path.home()))
+
+        expanded = os.path.expanduser(os.path.expandvars(target))
+        try:
+            old_pwd = os.getcwd()
+            os.chdir(expanded)
+            os.environ["OLDPWD"] = old_pwd
+            os.environ["PWD"] = os.getcwd()
+            return 0
+        except Exception as e:
+            render_error(f"cd: {e}")
+            return 1
+
+    def _handle_export(self, line: str) -> int:
+        """Handles 'export KEY=VALUE' builtin."""
+        parts = line[6:].strip().split("=", 1)
+        if len(parts) == 2:
+            key, val = parts[0].strip(), parts[1].strip().strip('"').strip("'")
+            os.environ[key] = val
+            render_success(f"Exported {key}={val}")
+            return 0
+        else:
+            render_error("Usage: export KEY=VALUE")
+            return 1
+
+    def _show_help(self) -> None:
+        """Displays ezShell usage guide."""
+        help_text = """
+[bold cyan]ezShell Built-in Commands:[/bold cyan]
+  [bold]!ask <question>[/bold]    Ask AI any command-line, DevOps, or system question
+  [bold]!fix[/bold]               Re-run or review the last suggested fix command
+  [bold]!config[/bold]            Inspect active configuration and model settings
+  [bold]!help[/bold]              Display this help overview
+  [bold]clear[/bold]              Clear the terminal screen
+  [bold]exit[/bold] or [bold]quit[/bold]      Leave ezShell
+
+[bold cyan]Key Features:[/bold cyan]
+    • Automatic failure detection with root cause diagnosis via Groq ([green]openai/gpt-oss-120b[/green])
+  • One-click fix execution with built-in destructive command guard
+  • Command and path autocompletion ([italic]Tab[/italic]), auto-suggestions ([italic]Right Arrow[/italic])
+  • Press [bold]Ctrl+Space[/bold] to quickly begin an [bold]!ask[/bold] query
+"""
+        console.print(Panel(help_text.strip(), title="ezShell Help", border_style="cyan"))
+
+    def _show_config(self) -> None:
+        """Displays the active configuration."""
+        has_key = bool(self.config.get_effective_api_key())
+        masked_key = (
+            f"...{self.config.get_effective_api_key()[-6:]}"
+            if has_key and len(self.config.get_effective_api_key() or "") > 6
+            else "[red]Not configured[/red]"
+        )
+
+        cfg_text = f"""
+[bold cyan]Model:[/bold cyan] {self.config.model}
+[bold cyan]API Key:[/bold cyan] {masked_key}
+[bold cyan]Temperature:[/bold cyan] {self.config.temperature}
+[bold cyan]Max Tokens:[/bold cyan] {self.config.max_tokens}
+[bold cyan]Auto Suggest Fix:[/bold cyan] {self.config.auto_suggest_fix}
+[bold cyan]Stream Explanation:[/bold cyan] {self.config.stream_explanation}
+"""
+        console.print(Panel(cfg_text.strip(), title="ezShell Configuration", border_style="cyan"))
+
+    def execute_single_command(self, cmd_str: str) -> int:
+        """Executes a single command line and returns the exit code."""
+        cmd = cmd_str.strip()
+        if not cmd:
+            return 0
+
+        # Builtin: cd
+        if cmd == "cd" or cmd.startswith("cd "):
+            args = cmd.split()[1:]
+            code = self._handle_cd(args)
+            self.last_exit_code = code
+            return code
+
+        # Builtin: export
+        if cmd.startswith("export ") and "=" in cmd:
+            code = self._handle_export(cmd)
+            self.last_exit_code = code
+            return code
+
+        # Builtin: clear
+        if cmd == "clear":
+            console.clear()
+            return 0
+
+        # Standard execution via PTY
+        result = PTYExecutor.execute(cmd, cwd=os.getcwd())
+        self.last_exit_code = result.exit_code
+
+        # Record in history
+        import time
+        self.history_entries.append(
+            CommandHistoryEntry(command=cmd, exit_code=result.exit_code, timestamp=time.time())
+        )
+        if len(self.history_entries) > self.config.max_history_items:
+            self.history_entries.pop(0)
+
+        # Handle failure if command failed
+        if result.exit_code != 0:
+            self._handle_command_failure(result.command, result.exit_code, result.clean_output)
+
+        return result.exit_code
+
+    def _handle_command_failure(self, command: str, exit_code: int, clean_output: str) -> None:
+        """Triggers AI diagnosis and presents fix options to the user."""
+        if not self.config.get_effective_api_key():
+            console.print(
+                "\n[dim #3b4261]─[/] [#e0af68] Command failed[/] "
+                "[dim #565f89]• Set GROQ_API_KEY in .env.local to enable instant AI fixes[/]\n"
+            )
+            return
+
+        if self.assistant is None:
+            self.assistant = ShellAssistant(config=self.config)
+
+        context = SystemContext.collect(history=self.history_entries)
+
+        with console.status(
+            f"[cyan]Analyzing failure with Groq ({self.config.model})...[/cyan]",
+            spinner="dots",
+        ):
+            try:
+                diagnostic = self.assistant.diagnose_failure(
+                    command=command,
+                    exit_code=exit_code,
+                    error_output=clean_output,
+                    context=context,
+                )
+            except Exception as e:
+                render_error(f"Error consulting Groq assistant: {e}")
+                return
+
+        # Render diagnostic card
+        render_error_card(diagnostic)
+
+        if diagnostic.suggested_fix and self.config.auto_suggest_fix:
+            self.last_suggested_fix = diagnostic.suggested_fix
+            action = prompt_fix_action(
+                fix_command=diagnostic.suggested_fix,
+                safety_report=diagnostic.safety_report,
+            )
+            if action == "run":
+                console.print(f"[cyan]Executing fix:[/cyan] [bold]{diagnostic.suggested_fix}[/bold]\n")
+                self.execute_single_command(diagnostic.suggested_fix)
+            elif action == "edit":
+                # Will return control back to prompt with suggested command as default
+                render_info("Tip: Copy and edit the suggested fix command above.")
+
+    def run(self) -> None:
+        """Starts the interactive ezShell REPL loop."""
+        initial_context = SystemContext.collect()
+        render_banner(self.config.model, initial_context.shell_name)
+
+        if not self.config.get_effective_api_key():
+            render_api_key_missing_card()
+
+        session = create_prompt_session()
+
+        while True:
+            try:
+                context = SystemContext.collect(history=self.history_entries)
+                prompt_html = get_prompt_text(context, self.last_exit_code)
+
+                user_input = session.prompt(prompt_html)
+                line = user_input.strip()
+
+                if not line:
+                    continue
+
+                # Exit check
+                if line in ("exit", "quit"):
+                    console.print("[dim]Goodbye from ezShell![/dim]")
+                    break
+
+                # Builtin: help
+                if line == "!help":
+                    self._show_help()
+                    continue
+
+                # Builtin: config
+                if line == "!config":
+                    self._show_config()
+                    continue
+
+                # Builtin: fix
+                if line == "!fix":
+                    if self.last_suggested_fix:
+                        console.print(f"[cyan]Running last suggested fix:[/cyan] {self.last_suggested_fix}\n")
+                        self.execute_single_command(self.last_suggested_fix)
+                    else:
+                        render_info("No recent fix available.")
+                    continue
+
+                # Builtin: ask
+                if line.startswith("!ask"):
+                    query = line[4:].strip()
+                    if not query:
+                        render_info("Usage: !ask <your question here>")
+                        continue
+                    self._handle_ask(query, context)
+                    continue
+
+                # Standard command execution
+                self.execute_single_command(line)
+
+            except (KeyboardInterrupt, EOFError):
+                console.print("\n[dim]ezShell session terminated.[/dim]")
+                break
+            except Exception as e:
+                render_error(f"Unexpected error: {e}")
+
+    def _handle_ask(self, query: str, context: SystemContext) -> None:
+        """Handles natural language inquiry with AI assistant."""
+        if not self.config.get_effective_api_key():
+            render_error("Cannot execute !ask: GROQ_API_KEY is not configured.")
+            return
+
+        if self.assistant is None:
+            self.assistant = ShellAssistant(config=self.config)
+
+        with console.status(f"[cyan]Asking Groq ({self.config.model})...[/cyan]", spinner="dots"):
+            try:
+                result = self.assistant.ask(query, context)
+            except Exception as e:
+                render_error(f"Error querying Groq: {e}")
+                return
+
+        render_ask_card(result)
+
+        if result.suggested_fix:
+            self.last_suggested_fix = result.suggested_fix
+            action = prompt_fix_action(
+                fix_command=result.suggested_fix,
+                safety_report=result.safety_report,
+            )
+            if action == "run":
+                console.print(f"[cyan]Executing:[/cyan] [bold]{result.suggested_fix}[/bold]\n")
+                self.execute_single_command(result.suggested_fix)
+