ezshell 0.2.0__tar.gz

ezshell-0.2.0/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/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,154 @@
+<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/ezshell.egg-info/PKG-INFO

@@ -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/ezshell.egg-info/SOURCES.txt

@@ -0,0 +1,59 @@
+LICENSE
+README.md
+pyproject.toml
+ezshell.egg-info/PKG-INFO
+ezshell.egg-info/SOURCES.txt
+ezshell.egg-info/dependency_links.txt
+ezshell.egg-info/entry_points.txt
+ezshell.egg-info/requires.txt
+ezshell.egg-info/top_level.txt
+src/__init__.py
+src/app.py
+src/i18n.py
+src/main.py
+src/core/__init__.py
+src/core/assistant.py
+src/core/capture.py
+src/core/chat_bridge.py
+src/core/config.py
+src/core/context.py
+src/core/groq_client.py
+src/core/llm_client.py
+src/core/prompts.py
+src/core/provider.py
+src/core/proxy_client.py
+src/core/pty_shell.py
+src/core/redact.py
+src/core/risk.py
+src/core/safety.py
+src/core/sanitize.py
+src/core/schema.py
+src/core/shell_hook.py
+src/core/suggest.py
+src/core/updater.py
+src/ui/chat_tui.py
+src/ui/gui_window.py
+src/ui/inline.py
+src/ui/logo.py
+src/ui/panel.py
+src/ui/prompt.py
+src/ui/render.py
+tests/test_assistant.py
+tests/test_capture_suggest.py
+tests/test_chat_bridge.py
+tests/test_chat_tui.py
+tests/test_config.py
+tests/test_context.py
+tests/test_e2e_shell.py
+tests/test_proxy_client.py
+tests/test_pty_shell.py
+tests/test_redact.py
+tests/test_redact_extra.py
+tests/test_release_files.py
+tests/test_risk.py
+tests/test_risk_powershell.py
+tests/test_safety.py
+tests/test_sanitize_schema.py
+tests/test_shell_hook.py
+tests/test_shell_hook_powershell.py
+tests/test_updater.py

ezshell-0.2.0/ezshell.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ezshell-0.2.0/ezshell.egg-info/entry_points.txt

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

ezshell-0.2.0/ezshell.egg-info/requires.txt

@@ -0,0 +1,9 @@
+groq>=0.11.0
+prompt_toolkit>=3.0.40
+rich>=13.7.0
+pyte>=0.8.2
+python-dotenv>=1.0.0
+textual>=8.0.0
+customtkinter>=6.0.0
+pillow>=10.0.0
+pydantic>=2.5

ezshell-0.2.0/ezshell.egg-info/top_level.txt

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

ezshell-0.2.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ezshell"
+dynamic = ["version"]
+description = "Terminal assistant: explains failed commands and suggests a fix you review before running"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Salomon" }]
+
+dependencies = [
+    "groq>=0.11.0",
+    "prompt_toolkit>=3.0.40",
+    "rich>=13.7.0",
+    "pyte>=0.8.2",
+    "python-dotenv>=1.0.0",
+    "textual>=8.0.0",
+    "customtkinter>=6.0.0",
+    "pillow>=10.0.0",
+    "pydantic>=2.5",
+]
+
+[project.scripts]
+ezsh    = "src.main:main"
+ezshell = "src.main:main"
+
+[tool.setuptools.dynamic]
+version = { attr = "src.__version__" }
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["src*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+

ezshell-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ezshell-0.2.0/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"