Un chemin clair vers
votre première invite.

Avant de commencer

1. Un système et un shell pris en charge : macOS ou Linux sur amd64/x86_64 ou arm64/aarch64, ou FreeBSD sur amd64. Utilisez Bash, zsh ou Fish. Les packages Arch sont uniquement x86_64. Il n'existe pas d'installateur natif Windows/PowerShell.
2. Accès au téléchargement : une connexion Internet fonctionnelle et un accès HTTPS fiable à GitHub, au référentiel de packages sélectionné et à votre fournisseur de modèles. L'inférence locale nécessite toujours un téléchargement initial du modèle.
3. Autorisations : un répertoire personnel accessible en écriture pour les ressources de chaque utilisateur. Les packages système Linux et macOS .pkg nécessitent un accès administrateur ; exécutez Homebrew et ash install en tant qu'utilisateur normal.
4. Un modèle : soit un serveur d'inférence local avec un modèle téléchargé, soit un compte cloud/une clé API. Choisissez un modèle qui prend en charge l’appel d’outils, et non un modèle image/audio uniquement. Les besoins locaux en RAM, disque et GPU dépendent de ce modèle.

Les packages ash prédéfinis ne nécessitent pas d'outils de build Go, Rust, Node.js ou Xcode. Un gestionnaire de packages peut avoir ses propres prérequis ; suivez d'abord ses instructions de configuration officielles.

macOS

Recommandé : Homebrew

Prérequis :Homebrew, son environnement macOS pris en charge et un système fonctionnelbrewcommande. Le robinet sélectionne automatiquement l'archive Intel ou Apple Silicon. Homebrew 6 ne fait pas implicitement confiance à ce robinet tiers. Si Homebrew refuse de charger la formule comme étant non fiable, vérifiez l'éditeur et la formule, puis faites confiance uniquement à cette formule (pas à l'intégralité du robinet) :

brew trust --formula jonconradt/ash/ash
brew install Jonconradt/ash/ash
ash version

Homebrew se souvient de cette décision de confiance locale. Le robinet ne peut pas activer la confiance en votre nom ; faire confiance à tout le robinet avecbrew trust jonconradt/ashest plus large et permet également de charger ses autres formules. Pour faire plutôt confiance à Beta ou Nightly, utilisez le nom de la formule correspondante,jonconradt/ash/ash-betaoujonconradt/ash/ash-nightly. Homebrew possède les binaires, les plugins natifs fournis, les pages de manuel et les avis de licence dans son préfixe (normalement/opt/homebrewsur Apple Silicon ou/usr/localsur Intel). Il vérifie l'archive par rapport à la somme de contrôle SHA-256 de la formule. Il ne configure pas votre fournisseur et ne modifie pas votre fichier de démarrage shell : continuez versinitialisation par utilisateur. Utiliserbrew upgrade ashpour les mises à jour etbrew uninstall ashpour supprimer Release ; voirformules de canalpour la version bêta/nuit.

Alternative : .pkg natif

Téléchargez ledarwin-arm64.pkgactif pour Apple Silicon oudarwin-amd64.pkgpour Intel d'unversion publiée.Vérifier son manifeste de somme de contrôle signéavant d'ouvrir le programme d'installation. L'accès administrateur est requis.

Le paquet écritashetash-brokerà/usr/local/bin, des plugins pour/usr/local/lib/ash/plugins, pages de manuel vers/usr/local/share/man, et des avis à/usr/local/share/licenses/ash. Le reçu estdev.ash.cli. Il n'exécute pas d'initialisation par utilisateur et ne s'abonne pas aux mises à jour :initialiseraprès l'installation, remplacez-le par un fichier .pkg plus récent et vérifié à mettre à jour et utilisez leprocédure de suppression manuelleà désinstaller. Ne l'installez pas sur une copie appartenant à Homebrew.

Linux

Utilisez le gestionnaire de packages de votre distribution lorsque cela est possible. Ces packages possèdent/usr/bin/ash,/usr/bin/ash-broker,/usr/lib/ash/plugins, pages de manuel sous/usr/share/man, et les avis de licence. Ils laissent les paramètres du fournisseur et les hooks du shell àinitialisation par utilisateur.

Debian et Ubuntu : APT

Prérequis : amd64 ou arm64, accès administrateur, APT,curl,gpget les certificats CA. Installez les outils de téléchargement/clés manquants à l'aide de votre distribution avant d'ajouter le référentiel. La version est nomméestable:

sudo apt update
sudo apt install ca-certificates curl gnupg
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://www.versionx.ai/apt/gpg.key -o versionx-apt.asc
gpg --show-keys --with-fingerprint versionx-apt.asc
sudo gpg --dearmor --batch --yes -o /etc/apt/keyrings/versionx-keyring.gpg versionx-apt.asc
sudo chmod 0644 /etc/apt/keyrings/versionx-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/versionx-keyring.gpg] https://www.versionx.ai/apt stable main" |
  sudo tee /etc/apt/sources.list.d/versionx.list
sudo apt update
sudo apt install ash
rm versionx-apt.asc

Avant d'importer une clé de référentiel, vérifiez son empreinte digitale par rapport à une source d'éditeur fiable. L'empreinte digitale de la clé VersionX est32C6 C11D 2F86 BFE4 6EB7 7FFC 5257 FEA6 1368 919F. APT vérifie les métadonnées signées du référentiel et les résumés de packages qu'il contient ; la clé est limitée àsigned-by. Mettre à jour avecsudo apt update && sudo apt upgrade ash; supprimer avecsudo apt remove ash.

Systèmes compatibles Fedora et RHEL : DNF

Prérequis : x86_64 ou aarch64, accès administrateur, DNF/RPM,curl,gpget les certificats CA. Installez les outils manquants de votre distribution. Inspectez la clé et comparez l’empreinte digitale ci-dessus avant de l’importer :

curl -fsSL https://www.versionx.ai/rpm/gpg.key -o versionx-rpm.asc
gpg --show-keys --with-fingerprint versionx-rpm.asc
sudo rpm --import versionx-rpm.asc
sudo tee /etc/yum.repos.d/versionx.repo >/dev/null <<'EOF'
[versionx]
name=VersionX ash repository
baseurl=https://www.versionx.ai/rpm/
enabled=1
gpgcheck=0
repo_gpgcheck=1
gpgkey=https://www.versionx.ai/rpm/gpg.key
EOF
sudo dnf install ash
rm versionx-rpm.asc

Les fichiers RPM ne sont pas signés individuellement.repo_gpgcheck=1vérifie les métadonnées du référentiel couvrant leurs sommes de contrôle ;gpgcheck=0reflète les signatures absentes par package, et non la vérification du référentiel désactivée. Si votre politique nécessite des charges utiles RPM signées, ce référentiel ne la respecte pas. Mettre à jour avecsudo dnf upgrade ash; supprimer avecsudo dnf remove ash.

Arch Linux : Pacman

Prérequis : x86_64, accès administrateur, Pacman avec son trousseau initialisé,curl, etgpg. Vérifiez que l'empreinte digitale de la clé affichée correspond à celle ci-dessus avant de lui faire confiance. Ajoutez le référentiel une fois, pas à chaque mise à jour :

curl -fsSL https://www.versionx.ai/pacman/gpg.key -o versionx-pacman.asc
gpg --show-keys --with-fingerprint versionx-pacman.asc
sudo pacman-key --add versionx-pacman.asc
sudo pacman-key --lsign-key 32C6C11D2F86BFE46EB77FFC5257FEA61368919F
sudo tee -a /etc/pacman.conf >/dev/null <<'EOF'
[versionx]
Server = https://www.versionx.ai/pacman/$arch
SigLevel = Required DatabaseRequired
EOF
sudo pacman -Syu ash
rm versionx-pacman.asc

Pacman vérifie les signatures des packages et de la base de données. Gardez Arch synchronisé avecsudo pacman -Syu, pas une mise à niveau partielle ; retirerashavecsudo pacman -R ash.

Autres méthodes d'installation de Linux

J'utilise déjàHomebrew sous Linux? Lemêmes instructions de robinetprend en charge amd64 et arm64 ; Brew est propriétaire de ces fichiers, pas APT/DNF. Sinon, utilisez uninstallation de scripts/archivesou une correspondanceTéléchargement .deb/.rpm. Installez un .deb vérifié avecsudo apt install ./PACKAGE.deb, ou un .rpm avecsudo dnf install ./PACKAGE.rpm(remplacer les noms de fichiers). Un package direct reste la propriété du gestionnaire de packages, mais n'ajoute pas de référentiel ni ne s'abonne automatiquement aux versions futures. La charge utile RPM actuelle n’est pas signée ; suivez la politique de votre distribution plutôt que de désactiver les vérifications de signature.

FreeBSD

Prérequis : amd64, Bash (même lorsque votre shell interactif est zsh ou Fish), des outils de téléchargement/vérification et un répertoire d'installation accessible en écriture. Installez Bash à l'aide du gestionnaire natif de FreeBSD :

sudo pkg install bash

FreeBSDpkggère les prérequis, pasash: il n'y a actuellement aucunashDépôt .pkg et pas d'archive de version arm64. Utilisez lescript vérifié, ouvérifier une archive tar FreeBSD amd64, extrayez-le dans un répertoire temporaire et installez son versionnéashbinaire comme~/.local/bin/ashaux côtésash-broker. Copiez ses plugins natifs dans$XDG_DATA_HOME/ash/plugins(défaut~/.local/share/ash/plugins), alorsinitialiser. Vous êtes propriétaire de ces fichiers ;pkg deletene les supprimera pas. UtiliserPublier des mises à jour automatiquesà l'emplacement par défaut ou remplacez manuellement les artefacts vérifiés.

Initialisez et vérifiez

Après avoir installé les binaires, exécutez l'installation de manière interactive en tant qu'utilisateur normal. Si vous ne souhaitez pas d'intégration shell, vous pouvez installer uniquement Ash. Ce n'est probablement pas ce que vous voulez. La vraie valeur de ash est l'intégration shell ci-dessous. La configuration des ressources uniquement laisse vos fichiers de démarrage inchangés :

ash install

L'installation que vous souhaiterez probablement utiliser implique une intégration shell. Cela modifiera votre .bashrc (ou l'équivalent pour votre shell) pour inclure Ash. Pour activer l'intégration des commandes introuvables, choisissez exactement une commande pour le shell que vous utilisez :

Bash

ash install --shell bash --shell-integration

zsh

ash install --shell zsh --shell-integration

Poisson

ash install --shell fish --shell-integration

Bash utilise~/.bashrc, zsh utilise~/.zshrc, et le poisson utilise$XDG_CONFIG_HOME/fish/config.fish(défaut~/.config/fish/config.fish). Ouvrez ensuite un nouveau shell ; les shells existants conservent leur courtier en cours d'exécution. Préfixes d'intégration~/.local/binvers PATH : supprimez une ancienne copie locale de l'utilisateur avant de vous attendre à ce qu'un package système soit sélectionné.

Si les paramètres du fournisseur sont manquants, le programme d'installation détecte les clés de fournisseur existantes ou un serveur local en cours d'exécution ; sinon, il propose un menu de fournisseur et demande des informations d'identification. Choisissez un modèle disponible compatible avec les outils. Les paramètres valides existants sont conservés, donc la réexécution de l’installation n’est pas une commande de changement de fournisseur.

Les paramètres sont stockés dans$XDG_CONFIG_HOME/ash/.ash_env(défaut~/.config/ash/.ash_env, autorisations de fichiers privés). L'intégration gérée les charge. Sans intégration, les utilisateurs de Bash/zsh peuvent rechercher ce fichier dans leur configuration de démarrage normale ; Les utilisateurs de poissons doivent définir le paramètre correspondantASH_AI_*variables utilisant la syntaxe Fish, et non la source du fichier au format Bash. Protégez tout fichier contenant des jetons et ne le validez jamais.

Pour une installation utilisateur locale sans intégration, ajoutez son répertoire réel à PATH. Bash/zsh :export PATH="$HOME/.local/bin:$PATH". Poisson:fish_add_path "$HOME/.local/bin". Conservez cela en utilisant la configuration de démarrage de votre shell ; remplacez votre répertoire d'installation personnalisé le cas échéant.

command -v ash
command -v ash-broker
ash version
ash "Say hello in one sentence"

Les premières commandes devraient résoudre l'installation que vous avez choisie. L'invite nécessite un serveur en cours d'exécution ou des informations d'identification cloud valides ; l'installation de ash n'installe pas de modèle.

Ollama local : aucun compte cloud requis

Vous n'avez pas besoin d'avoir une IA locale pour l'utiliserash. Toutefois, si vous souhaitez exécuter des modèles localement sans recourir à un fournisseur de cloud, vous pouvez configurer un serveur Ollama local.

Ollama propose également un service cloud pour exécuter des modèles à distance, mais cela n'est pas requis pour une utilisation locale avecash. Le serveur cloud comprend un niveau gratuit et le modèle cloud Gemma 4 31b de Google (gemma4-31b:nuage) fonctionne très bien avecash. Il s'agit du modèle utilisé par le projet pour générer des notes de version et effectuer des tâches de développement.

Installez Ollama en utilisant soninstructions officielles du système d'exploitation. Démarrez l'application/le service Ollama ou exécutezollama servedans un terminal séparé si aucun serveur n'est déjà en cours d'exécution. Sur FreeBSD,ashLe support de n'implique pas un installateur natif d'Ollama : utilisez un serveur accessible sur un autre hôte pris en charge si nécessaire.

Téléchargez un modèle compatible avec les outils et adapté à votre matériel ;llama3.1:8best un exemple et non une exigence minimale. Vérifiez lecatalogue d'outils actuelpour les alternatives :

ollama pull llama3.1:8b
ollama list
curl -fsS http://localhost:11434/api/tags
ash install

En l'absence de clé cloud déjà définie, le programme d'installation peut détecter le serveur local et proposer le modèle téléchargé. Si un autre fournisseur est déjà configuré, modifiez manuellement le point de terminaison/modèle. Exemple Bash/zsh :

export ASH_AI_ENDPOINT="http://localhost:11434"
export ASH_AI_MODEL="llama3.1:8b"
unset ASH_AI_AUTH_TOKEN
ash "Say hello in one sentence"

Équivalent poisson :

set -gx ASH_AI_ENDPOINT http://localhost:11434
set -gx ASH_AI_MODEL llama3.1:8b
set -e ASH_AI_AUTH_TOKEN
ash "Say hello in one sentence"

Ces modifications affectent uniquement le shell actuel. Conservez-les dans votre espace protégéashfichier d'environnement ou une configuration shell appropriée, remplaçant tout ancien remplacement de fournisseur. L'Ollama local n'a pas besoin de jeton. Gardez le serveur en boucle, sauf si vous sécurisez délibérément l'accès ; un serveur distant reçoit vos invites et les résultats de l'outil.

Facultatif : définirOLLAMA_KEEP_ALIVE=30mdans leServeur Ollamaenvironnement et redémarrez le serveur pour garder les modèles au chaud.-1les maintient chargés indéfiniment mais consomme de la mémoire entre les requêtes. Définir cela uniquement dans leashle terminal client ne reconfigure pas un serveur déjà en cours d'exécution.

L'inférence locale n'a pas de facture API de fournisseur, mais utilise votre matériel/stockage/électricité.Nuage d'ollamaest un service distinct avec des limites d'authentification et de forfait ; ce n'est pas la même chose que cette configuration locale.

Niveaux cloud gratuits

Créez une clé de fournisseur à l'aide des liens ci-dessous, puis exécutez ash install de manière interactive et choisissez ce fournisseur. Le programme d’installation demande le jeton et répertorie les modèles pris en charge. Choisissez un modèle de texte gratuit actuellement disponible avec appel d'outils ; lister un modèle ne garantit pas qu'il est gratuit pour votre compte.

Vous exportez déjà une clé de fournisseur reconnu ? Le programme d'installation le détecte ; si plusieurs clés existent, il vous demande de choisir. Ne collez pas de vraies clés dans l’historique des commandes, les enregistrements ou le code source. Le fichier de configuration contient un secret et non un coffre-fort chiffré.

Configuration manuelle ou changement de fournisseur

Remplacez le point de terminaison ci-dessous par la valeur du tableau etMODEL_IDavec un modèle vérifié dans votre compte fournisseur. Si votre clé est déjà exportée sousGROQ_API_KEY, cet exemple Bash/zsh le réutilise sans taper le secret :

export ASH_AI_ENDPOINT="https://api.groq.com/openai/v1"
export ASH_AI_MODEL="MODEL_ID"
export ASH_AI_AUTH_TOKEN="$GROQ_API_KEY"

Équivalent poisson :

set -gx ASH_AI_ENDPOINT https://api.groq.com/openai/v1
set -gx ASH_AI_MODEL MODEL_ID
set -gx ASH_AI_AUTH_TOKEN "$GROQ_API_KEY"

Pour Gemini ou OpenRouter, utilisez plutôt leur point de terminaison et leur variable clé reconnue. Enregistrez les paramètres choisis en toute sécurité pour les futurs shells. Les points de terminaison du cloud nécessitent HTTPS et un jeton ; Le HTTP local n'est pas un raccourci pour un service cloud. Voirla référence environnementetautres fournisseurs pris en chargepour les services payants et les remplacements avancés.

Installation de script : une alternative, pas le premier choix

Préférez Homebrew, APT, DNF ou Pacman : ils suivent les fichiers détenus, vérifient les téléchargements à l'aide de leur configuration de confiance et fournissent des mises à jour/suppressions familières. Ils nécessitent toujours des éditeurs de confiance et des actions d'installation de packages.

Prérequis : un OS/architecture supporté,$SHELLidentifier Bash/zsh/Fish,Cosignature Sigstore,tar,uname,install, des utilitaires shell standard, une commande SHA-256 (sha256sum,shasum, ousha256), et un téléchargeur (curl,wget, ou Python). L'exemple utilise curl. FreeBSD a également besoin de Bash. Votre répertoire home/installation doit être accessible en écriture.

Téléchargez dans un fichier local, inspectez-le avec un éditeur et exécutez-le uniquement si vous faites confiance à sa source et à son comportement. L'inspection n'est pas une garantie de sécurité ; n'exécutez pas ces étapes aveuglément :

curl -fsSL https://jonconradt.github.io/ash/install.sh -o ash-install.sh
less ash-install.sh

Après inspection, exécutez la copie enregistrée en tant qu'utilisateur normal :

sh ./ash-install.sh
rm ./ash-install.sh

install.shtélécharge la dernière version, vérifie son manifeste de somme de contrôle et son résumé d'archive signés Sigstore, et installeash/ash-brokerdans~/.local/bin. Les plugins natifs disparaissent$XDG_DATA_HOME/ash/plugins. Il exécute la configuration par utilisateur et demande avant d'activer l'intégration du shell. Sans terminal interactif, les invites du fournisseur/intégration peuvent être ignorées : exécuterash installde manière interactive par la suite.

Vous pouvez définirASH_INSTALL_DIRavant d'exécuter le script pour choisir une autre destination. Ajoutez vous-même cette destination à PATH.La mise à jour automatique est prise en charge uniquement sous~/.local/bin; les destinations personnalisées nécessitent un remplacement manuel. Le script n'a pas de sélecteur Beta/Nightly.

Vérifier un package direct ou une archive

Prérequis : cosignature et un utilitaire SHA-256. À partir de la même version publiée, téléchargez votre package/archive,SHA256SUMS, etSHA256SUMS.sigstore.json. Travaillez dans un nouveau répertoire. RemplacervX.Y.Zavec la balise exacte, y compris un suffixe de préversion le cas échéant :

cosign verify-blob SHA256SUMS \
  --bundle SHA256SUMS.sigstore.json \
  --certificate-identity "https://github.com/Jonconradt/ash/.github/workflows/release.yml@refs/tags/vX.Y.Z" \
  --certificate-oidc-issuer "https://token.actions.githubusercontent.com"

Seulement après que cela réussisse, calculez le résumé de votre fichier avecshasum -a 256 PACKAGEsur macOS,sha256sum PACKAGEsous Linux, ousha256 -q PACKAGEsur FreeBSD. RemplacerPACKAGEavec le nom de fichier téléchargé et comparez-le exactement avec l'entrée de ce nom de fichier dans le manifeste vérifié. Arrêtez-vous sur une entrée manquante ou toute incohérence. Une somme de contrôle non signée téléchargée à côté d'un fichier n'est pas équivalente aux métadonnées vérifiées de l'éditeur.

Mises à jour et les trois chaînes

• Sortie (recommandée) :versions publiées stables telles quevX.Y.Z; la configuration du référentiel appelle cecistable.
• Bêta:tests préliminaires, taguévX.Y.Z-beta.N; attendez-vous à des changements et des régressions.
• Chaque nuit:modifications récentes de la branche par défaut, étiquetéesvX.Y.Z-nightly.YYYYMMDD.N; le risque de régression le plus élevé. Les builds sont planifiées mais peuvent être ignorées lorsque rien ne change ou que la publication échoue.

Une version publiée met à jour la formule Homebrew correspondante ou le référentiel Linux signé. Vous le recevez lorsque vous exécutez la commande de mise à niveau du gestionnaire propriétaire (ou votre propre politique de mise à jour du système d'exploitation le fait). La publication, les mises à jour du référentiel et le déploiement du site Web peuvent être en retard ; vérifiez la disponibilité avant de changer de chaîne. ash n'installe pas silencieusement les mises à jour binaires en arrière-plan.

Homebrew : installer ou changer de formule

Pour une nouvelle installation bêta/nuit, utilisez le nom complet de la formule correspondante ci-dessus dans brew install. Lors du changement, désinstallez d'abord la formule actuellement installée : toutes les trois fournissent les mêmes binaires. Exemple de version bêta :

brew uninstall ash
brew install Jonconradt/ash/ash-beta
brew update
brew upgrade ash-beta

Utiliserash-nightlypour la nuit ouashpour Release dans les commandes d’installation/mise à niveau. Désinstallez la formule actuelle de l'ancienne chaîne, pas toujoursash. Les paramètres utilisateur sont conservés ; ouvrez un nouveau shell après le changement.

Linux : sélectionnez un canal de référentiel

APTE:utiliser leConfiguration APTavec exactement une distribution du tableau. Pour changer une installation existante, modifiez/etc/apt/sources.list.d/versionx.list, remplaçantstableavecbetaounightly(ou retour àstable), alors:

sudo apt update
sudo apt install --allow-downgrades ash

DNF :utiliser leConfiguration DNFavec le baseurl sélectionné. Pour une installation existante, remplacezbaseurldans/etc/yum.repos.d/versionx.repo, en conservant ses paramètres de signature, puis :

sudo dnf --refresh distro-sync ash

Pacman :utiliser leConfiguration de Pacmanavec l'URL du serveur sélectionné. Conserver le nom de la section[versionx]: chaque chaîne publie une base de données nomméeversionx.db. Modifiez le serveur dans cette section plutôt que d'ajouter une base de données nommée différemment. Pour changer, y compris un déclassement :

sudo pacman -Syuu ash

Examinez la transaction proposée : le retour à Release peut rétrograder ash, et le double de Pacman u peut également rétrograder d'autres packages. Sauvegardez la configuration avant de changer. Ensuite, utilisez les commandes de mise à niveau APT/DNF/Pacman normales à partir des sections du système d'exploitation ; ne laissez pas plusieurs sources de canaux ash activées.

Mises à jour de la version locale de l'utilisateur

ash update

Cela vérifie et installe une version stable uniquement lorsque la version activeashl'exécutable est sous~/.local/bin. Il met également à jour les actifs/plugins groupés, avec des choix de fichiers personnalisés.ash update --version vX.Y.Zsélectionne une balise stable, pas un canal ; ce n'est pas une commande de rétrogradation. Il n'y a pas--channeloption. Les installations du gestionnaire de packages, les installations macOS .pkg et les destinations de script personnalisées doivent plutôt utiliser leur propre gestionnaire/installateur. FreeBSD Beta/Nightly utilise des archives vérifiées manuellement, pas un abonnement de mise à jour automatique. Ouvrez un nouveau shell après la mise à jour.

Désinstaller sans supprimer les fichiers sans rapport

1. Désactivez d'abord l'intégration du shell

Avant de supprimer les binaires, exécutez la commande pour chaque shell sur lequel vous avez activé l'intégration :

Bash

ash install --shell bash --disable-shell-integration

zsh

ash install --shell zsh --disable-shell-integration

Poisson

ash install --shell fish --disable-shell-integration

Siashest déjà manquant, modifiez le fichier de démarrage correspondant à partir deinitialisationet supprimez uniquement le bloc entre# >>> ash install >>>et# <<< ash install <<<. Supprimez toutash-lignes PATH/environnement spécifiques que vous avez ajoutées manuellement, et non sans rapport avec la configuration du shell. Fermerash- a ensuite activé les shells afin que leurs courtiers appartenant à des shells quittent.

2. Laissez le gestionnaire de packages propriétaire supprimer ses fichiers

Homebrew (version)

brew uninstall ash

APT

sudo apt remove ash

DNF

sudo dnf remove ash

Pacman

sudo pacman -R ash

Choisissez uniquement votre méthode d'installation ; pour Homebrew Beta/utilisation nocturneash-beta/ash-nightly. APT/DNF/Pacman supprime les binaires, plugins et pages de manuel appartenant au package, et non la configuration/l'historique de votre répertoire personnel. Ne supprimez pas manuellement les fichiers appartenant au package.

Nettoyage du référentiel facultatif : supprimez leashfichier source/etc/apt/sources.list.d/versionx.listet son dédié/etc/apt/keyrings/versionx-keyring.gpg, ou leashfichier de référentiel/etc/yum.repos.d/versionx.repo, ou leash [versionx]section de/etc/pacman.conf. Vérifiez d’abord qu’aucun autre package ne les utilise. Supprimez une clé de confiance RPM/Pacman importée uniquement après avoir confirmé son empreinte digitale et que rien d'autre ne dépend d'elle ; ne supprimez jamais le trousseau partagé d’une distribution.

3a. Suppression manuelle de macOS .pkg

Le programme d'installation de macOS enregistre un reçu mais n'en a aucunashprogramme de désinstallation. Confirmez qu'il s'agit d'une installation .pkg, et non d'Homebrew, et inspectez sa charge utile exacte :

pkgutil --pkg-info dev.ash.cli
pkgutil --files dev.ash.cli

En utilisant ce reçu comme inventaire, supprimez uniquement sonash-fichiers appartenant :/usr/local/bin/ash,/usr/local/bin/ash-broker, les fichiers dans/usr/local/lib/ash/plugins,/usr/local/share/man/man1/ash.1, la liste localiséeash.1pages et avis dans/usr/local/share/licenses/ash. Des privilèges d'administrateur sont nécessaires. Vérifiez la propriété si un autre installateur a ensuite remplacé ces fichiers ; ne supprimez pas sa copie. Supprimer videash-uniquement les répertoires, non partagés/usr/local,bin, ou des répertoires man.

Après avoir supprimé la charge utile, supprimez éventuellement le reçu :

sudo pkgutil --forget dev.ash.cli

Oublier un reçu ne supprime aucun fichier installé.Conservez-le jusqu'à ce que vous ayez fini de vérifier la charge utile.

3b. Suppression manuelle des archives utilisateur-local / Linux / FreeBSD

Localisez la copie active aveccommand -v ashetcommand -v ash-broker. Pour l'installation du script par défaut, après avoir désactivé les hooks, supprimez ces deux fichiers spécifiques :

rm "$HOME/.local/bin/ash" "$HOME/.local/bin/ash-broker"

PourASH_INSTALL_DIRou une archive extraite manuellement, supprimez uniquement le fichier réellement installéash/Chemins de courtier. Supprimez les plugins d'archive/pages de manuel/notifications que vous avez installés à l'aide de votre inventaire de fichiers d'origine ; les plugins de script sont dans leashrépertoire de données utilisateur. Si les fichiers sont sous/usr/bin, vérifiez d'abord la propriété avecdpkg -S /usr/bin/ash,rpm -qf /usr/bin/ash, oupacman -Qo /usr/bin/ashle cas échéant. Une copie appartenant au package doit être supprimée via ce gestionnaire, même si elle est installée à partir d'un téléchargement autonome.

4. Facultatif : effacez les paramètres locaux, les outils et l'historique

• Configuration:$XDG_CONFIG_HOME/ash, défaut~/.config/ash.
• Données, plugins et environnement Python :$XDG_DATA_HOME/ash, défaut~/.local/share/ash.
• Histoire et état :$XDG_STATE_HOME/ash, défaut~/.local/state/ash.
• Cache :$XDG_CACHE_HOME/ash, défaut~/.cache/ash.
• Durée d'exécution du courtier :$XDG_RUNTIME_DIR/ash, ou$XDG_STATE_HOME/ash/runtimelorsqu'aucune racine d'exécution n'est disponible.

Inspectez vos remplacements XDG absolus réels avant de supprimer uniquement ces sous-répertoires ash ; ne supprimez jamais une racine XDG ou votre répertoire personnel. Une fois tous les shells compatibles ash fermés, supprimez les fichiers d'exécution ash restants si nécessaire. Les informations d'identification MCP OAuth peuvent également rester dans le gestionnaire d'informations d'identification du système d'exploitation : supprimez-y les entrées spécifiques à ash et révoquez l'accès au fournisseur MCP. Révoquer les clés AI inutilisées dans leurs comptes fournisseurs ; la suppression d'un fichier local ne révoque pas une clé. Ne désinstallez pas Ollama/models, Python ou les dépendances partagées dans le cadre de la suppression de ash.

Dépannage rapide

Commande introuvable ou mauvaise version

Vérifiez CHEMIN etcommand -v ash/command -v ash-broker. Un vieux~/.local/binla copie peut observer un package. Utilisez un propriétaire/canal à la fois et ouvrez un nouveau shell.

Le menu du fournisseur n'apparaît pas

Courirash installdepuis une borne interactive. Les paramètres valides existants sont conservés ; utiliserconfiguration manuellepour changer de fournisseur. Sans intégration, assurez-vous que les paramètres sont exportés dans l'environnement de la CLI.

Aucun modèle ni connexion refusé

Pour Ollama, confirmez que son serveur est en cours d'exécution etollama listcomprend le modèle choisi. Pour les services cloud, vérifiez le point de terminaison, l'éligibilité du modèle, HTTPS, le jeton et le quota de compte ; ne partagez jamais de journaux contenant des jetons.

Dépôt ou canal indisponible

Vérifiez l'architecture et la version/référentiel publié. La publication peut prendre du retard ; ne désactivez pas la vérification de signature pour contourner un référentiel indisponible.

La configuration de l'outil Python a échoué

Installez Python avec venv/ensurepip et autorisez les téléchargements de dépendances, puis réexécutezash install. Basiqueashreste utilisable sans ces outils.

Besoin de plus de détails ? Voirla référence de la commande,FAQ, ousignaler un problèmesans informations d'identification.