E klore Wee op
Är éischt Ufro.

Ier Dir ufänkt

1. En ënnerstëtzte System a Shell: macOS oder Linux op amd64/x86_64 oder arm64/aarch64, oder FreeBSD op amd64. Benotzt Bash, zsh oder Fësch. Arch Packagen sinn nëmmen x86_64. Et gëtt keen native Windows/PowerShell Installateur.
2. Download Zougang:eng funktionéierend Internetverbindung a vertrauenswürdege HTTPS Zougang zu GitHub, dem gewielte Package Repository, an Ärem Modellprovider. Lokal Inferenz brauch nach ëmmer en initialen Modell Download.
3. Permissiounen:e schreiwenbare Heemverzeechnes fir Verméigen pro Benotzer. Linux System Packagen a macOS .pkg brauchen Administrator Zougang; lafen Homebrew an ash install als Ären normale Benotzer.
4. E Modell: entweder e lokalen Inferenzserver mat engem erofgeluede Modell oder e Cloud Account/API Schlëssel. Wielt e Modell deen Tool Calling ënnerstëtzt, net e Bild / Audio-nëmmen Modell. Lokal RAM, Disk, a GPU Bedierfnesser hänkt vun deem Modell of.

Prebuilt ash Packagen erfuerderen keng Go, Rust, Node.js oder Xcode Build Tools. E Package Manager kann seng eege Viraussetzunge hunn; befollegt als éischt seng offiziell Installatiounsinstruktiounen.

macOS

Recommandéiert: Homebrew

Viraussetzunge:Homebrew, seng ënnerstëtzt macOS Ëmfeld, an eng funktionéierendbrewKommando. Den Tap wielt den Intel oder Apple Silicon Archiv automatesch. Homebrew 6 vertraut net implizit dësen Drëtt Partei Krunn. Wann Homebrew refuséiert d'Formel als net zouverléisseg ze lueden, iwwerpréift de Verlag an d'Formel, vertrau dann nëmmen dës Formel (net de ganzen Krunn):

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

Homebrew erënnert un dës lokal VertrauensEntscheedung. Den Krunn kann net Vertrauen op Ärem Numm aktivéieren; Vertrauen de ganzen Krunn matbrew trust jonconradt/ashass méi breet an erlaabt och seng aner Formelen ze lueden. Fir Beta oder Nightly amplaz ze trauen, benotzt den entspriechende Formelnumm,jonconradt/ash/ash-betaoderjonconradt/ash/ash-nightly. Homebrew besëtzt d'Binaeren, gebündelt gebierteg Plugins, Mann Säiten, a Lizenznotifikatiounen a sengem Präfix (normalerweis/opt/homebrewop Apple Silicon oder/usr/localop Intel). Et kontrolléiert d'Archiv géint d'SHA-256 Checksum vun der Formel. Et konfiguréiert Äre Provider net oder ännert Är Shell-Startupdatei net: weiderpro Benotzer Initialiséierung. Benotztbrew upgrade ashfir Aktualiséierungen anbrew uninstall ashze läschen Fräisetzung; gesinnKanal Formulenfir Beta / Nightly.

Alternativ: gebierteg .pkg

Download dedarwin-arm64.pkgVerméigen fir Apple Silicon oderdarwin-amd64.pkgfir Intel aus engemverëffentlecht Verëffentlechung.Verifizéiere säi ënnerschriwwene Checksum Manifestier Dir den Installateur opmaacht. Administrator Zougang ass néideg.

De Pak schreiftashanash-brokerzu/usr/local/bin, Plugins fir/usr/local/lib/ash/plugins, Mann Säiten ze/usr/local/share/man, an Uschléi ze/usr/local/share/licenses/ash. De Empfang assdev.ash.cli. Et leeft net pro Benotzer Initialiséierung oder abonnéiert op Updates:initialiséierenno Installatioun, ersat et mat engem iwwerpréiften neier .pkg zu update, a benotzen d'manuell Ewechhuele Prozeduruninstalléieren. Installéiert et net iwwer eng Homebrew-Besëtzer Kopie.

Linux

Benotzt de Package Manager vun Ärer Verdeelung wou méiglech. Dës Packagen eegen/usr/bin/ash,/usr/bin/ash-broker,/usr/lib/ash/plugins, Mann Säiten ënner/usr/share/man, an Lizenz Uschléi. Si verloossen Provider Astellungen a Réibau Haken zepro Benotzer Initialiséierung.

Debian an Ubuntu: APT

Viraussetzunge: amd64 oder arm64, Administrator Zougang, APT,curl,gpg, an CA Certificaten. Installéiert fehlend Download / Schlëssel Tools mat Ärer Verdeelung ier Dir de Repository bäidréit. Verëffentlechung gëtt genanntstable:

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

Ier Dir e Repositoryschlëssel importéiert, kontrolléiert säi Fangerofdrock géint eng zouverléisseg Verëffentlechungsquell. De VersionX Schlëssel Fangerofdrock ass32C6 C11D 2F86 BFE4 6EB7 7FFC 5257 FEA6 1368 919F. APT kontrolléiert ënnerschriwwen Repository Metadaten an de Package verdaut et enthält; de Schlëssel ass scoped matsigned-by. Update matsudo apt update && sudo apt upgrade ash; ewechzehuelen matsudo apt remove ash.

Fedora a RHEL-kompatibel Systemer: DNF

Viraussetzunge: x86_64 oder aarch64, Administrator Zougang, DNF / RPM,curl,gpg, an CA Certificaten. Installéiert fehlend Tools vun Ärer Verdeelung. Kontrolléiert de Schlëssel a vergläicht de Fangerofdrock uewendriwwer ier Dir en importéiert:

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

RPM Dateien sinn net individuell ënnerschriwwen.repo_gpgcheck=1verifizéiert Repository Metadaten déi hir Kontrollsummen ofdecken;gpgcheck=0reflektéiert déi fehlend Per-Package Ënnerschrëften, net behënnert Repository Verifikatioun. Wann Är Politik ënnerschriwwen RPM Notzlaascht erfuerdert, entsprécht dëse Repository et net. Update matsudo dnf upgrade ash; ewechzehuelen matsudo dnf remove ash.

Arch Linux: Pacman

Viraussetzunge: x86_64, Administrator Zougang, Pacman mat sengem Schlësselring initialiséiert,curl,an angpg. Vergewëssert Iech datt de ugewisenen Schlëssel Fangerofdrock mat deem uewen entsprécht ier Dir et vertraut. Füügt de Repository eemol un, net op all Update:

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 verifizéiert souwuel Package wéi och Datebank Ënnerschrëften. Halen Arch synchroniséiert matsudo pacman -Syu, net eng partiell Upgrade; ewechzehuelenashmatsudo pacman -R ash.

Aner Linux Installatiounsmethoden

Scho benotztHomebrew op Linux? Déiselwecht tap UweisungenËnnerstëtzung amd64 an arm64; Brew gehéiert dës Dateien, net APT / DNF. Soss, benotzen eng verifizéiertSkript / Archivinstallatiounoder e passende.deb/.rpm eroflueden. Installéiert eng iwwerpréift .deb matsudo apt install ./PACKAGE.deb, oder engem .rpm matsudo dnf install ./PACKAGE.rpm(ersetzen d'Dateinamen). En direkten Package bleift Package-Manager-Besëtz, awer füügt kee Repository derbäi oder abonnéiert automatesch op zukünfteg Verëffentlechungen. Déi aktuell RPM Notzlaascht ass net ënnerschriwwen; befollegt Är Verdeelungspolitik anstatt d'Ënnerschrëftkontrollen auszeschalten.

FreeBSD

Viraussetzungen: amd64, Bash (och wann Är interaktiv Shell zsh oder Fish ass), Download-/Verifizéierungsinstrumenter, an e schreiwenbare Installatiounsverzeechnes. Installéiert Bash mat dem native Manager vum FreeBSD:

sudo pkg install bash

FreeBSDpkggeréiert Viraussetzunge, netash: et gëtt am Moment kengash.pkg Repository a kee Arm64 Verëffentlechungsarchiv. Benotzt deverifizéiert Skript, oderz'iwwerpréiwen e FreeBSD amd64 tarball, Extrait et an en temporäre Verzeichnis, an installéiert seng Versiounashbinär als~/.local/bin/ashniewentash-broker. Kopéiert seng gebierteg Plugins op$XDG_DATA_HOME/ash/plugins(Standard~/.local/share/ash/plugins), danninitialiséieren. Dir hutt dës Dateien;pkg deletewäert se net ewechhuelen. BenotztFräisetzung Self-Aktualiséierungenan der Standardplaz oder manuell verifizéiert Artefakte ersetzen.

Initialiséieren an z'iwwerpréiwen

Nodeems Dir Binären installéiert hutt, lafen d'Setup interaktiv wéi Ären normale Benotzer. Wann Dir keng Shellintegratioun wëllt, kënnt Dir nëmmen Ash installéieren. Dëst ass wahrscheinlech net wat Dir wëllt. De reelle Wäert vun ash ass d'Shell Integratioun hei drënner. Assets-only Setup léisst Är Startupdateien onverännert:

ash install

D'Installatioun déi Dir wahrscheinlech benotze wëllt, beinhalt d'Shellintegratioun. Dëst wäert Äert .bashrc änneren (oder d'Äquivalent fir Är Shell) fir Ash opzehuelen. Fir d'Kommando net fonnt Integratioun z'aktivéieren, wielt genau ee Kommando fir d'Shell déi Dir benotzt:

Bash

ash install --shell bash --shell-integration

zsh

ash install --shell zsh --shell-integration

Fësch

ash install --shell fish --shell-integration

Bash benotzt~/.bashrc, zsh benotzt~/.zshrc, a Fësch benotzt$XDG_CONFIG_HOME/fish/config.fish(Standard~/.config/fish/config.fish). Eng nei Schuel duerno opmaachen; bestehend Muschelen behalen hire Lafen Broker. Integratioun prepends~/.local/binop PATH: ewechzehuelen eng al Benotzer-lokal Kopie ier Dir erwaart datt e System Package ausgewielt gëtt.

Wann Provider Astellunge feelen, detektéiert de Setup existent Providerschlësselen oder e lafende lokale Server; soss bitt et e Provider Menü an Ufro fir Umeldungsinformatiounen. Wielt e verfügbaren Tool-fähig Modell. Bestehend gëlteg Astellunge sinn erhale bleiwen, sou datt d'Wiederlaaf vum Setup kee Provider-Switch Kommando ass.

Astellunge sinn gespäichert an$XDG_CONFIG_HOME/ash/.ash_env(Standard~/.config/ash/.ash_env, privat Dateierechter). Managed Integratioun lued se. Ouni Integratioun kënnen Bash / zsh Benotzer dës Datei an hirer normaler Startkonfiguratioun Quell; Fësch Benotzer sollen déi entspriechend FormatiounASH_AI_*Variabelen mat Fish Syntax, net Quell vun der Bash-Format Datei. Schützt all Datei mat Tokens an engagéiert se ni.

Fir eng Benotzer-lokal Installatioun ouni Integratioun, füügt säin aktuellen Verzeechnes op PATH. Bash/zsh:export PATH="$HOME/.local/bin:$PATH". Fësch:fish_add_path "$HOME/.local/bin". Bleift dëst mat der Startkonfiguratioun vun Ärer Shell; ersetzt Äre personaliséierten Installatiounsverzeechnes wann zoutreffend.

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

Déi éischt Befehle solle sech op d'Installatioun léisen déi Dir gewielt hutt. D'Prompt brauch e lafende Server oder gëlteg Cloud-Umeldungsinformatiounen; installéiert ash net e Modell installéiert.

Lokal Ollama: kee Cloud Kont erfuerderlech

Dir musst keng lokal AI hunn fir ze benotzenash. Wéi och ëmmer, wann Dir Modeller lokal wëllt lafen ouni op e Cloud Provider ze vertrauen, kënnt Dir e lokale Ollama Server astellen.

Ollama bitt och e Cloud-Service fir Modeller op afstand ze lafen, awer dat ass net erfuerderlech fir lokal Benotzung matash. De Cloud Server enthält e gratis Tier a Google's Gemma 4 31b Cloud Modell (gemma4-31b:woll) Wierker ganz gutt matash. Dëst ass de Modell dee vum Projet benotzt gëtt fir Verëffentlechungsnotizen ze generéieren an Devops Aufgaben auszeféieren.

Installéiert Ollama benotzt sengoffiziell OS Instruktiounen. Start der Ollama App / Service, oder lafenollama servean engem separaten Terminal wann e Server net scho leeft. Op FreeBSD,ashD'Ënnerstëtzung implizéiert keen gebiertege Ollama Installateur: benotzt en erreechbare Server op engem aneren ënnerstëtzten Host wann néideg.

Download engem Tool-fähig Modell datt Är Hardware passt;llama3.1:8bass e Beispill, net e Minimum Ufuerderung. Kuckt deaktuellen Tools Katalogfir Alternativen:

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

Ouni scho Cloud-Schlësselen agestallt, kann d'Setup de lokalen Server erkennen an den erofgeluede Modell ubidden. Wann en anere Provider scho konfiguréiert ass, ännert amplaz den Endpunkt / Modell manuell. Bash/zsh Beispill:

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"

Fëschequivalent:

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"

Dës Ännerungen beaflossen nëmmen déi aktuell Shell. Persistent hinnen an Ärer geschütztashËmfeld Datei oder entspriechend Shell Konfiguratioun, ersetzt all alen Provider iwwerschreiden. Lokal Ollama brauch keen Token. Halt de Server um Loopback ausser Dir bewosst Zougang sécher ass; e Fernserver kritt Är Ufroen an Tooloutput.

Optional: SetOLLAMA_KEEP_ALIVE=30man derOllama ServerËmfeld an Restart de Server fir Modeller waarm ze halen.-1hält se onbestëmmt gelueden awer verbraucht Erënnerung tëscht Ufroen. Astellung dëst nëmmen amashClient Terminal konfiguréiert net e scho lafende Server.

Lokal Inferenz huet kee Provider API Rechnung, mee benotzt Är Hardware / Stockage / Elektrizitéit.Ollama Wollekass e separaten Service mat Authentifikatioun a Planggrenzen; et ass net d'selwecht wéi dëse lokale Setup.

Gratis Cloud-Tier

Erstellt e Providerschlëssel mat de Linken hei drënner, fuert dann ash install interaktiv a wielt dee Provider. Setup freet fir den Token a lëscht Modeller wou ënnerstëtzt ginn. Wielt en aktuell verfügbare gratis-Tier Textmodell mat Tool Calling; Oplëschtung vun engem Modell garantéiert net datt et gratis ass fir Äre Kont.

Exportéiert schonn en unerkannten Providerschlëssel? Setup erkennt et; wann e puer Schlësselen existéieren, et freet Iech ze wielen. Paste keng richteg Schlësselen an Kommandogeschicht, Opzeechnungen oder Quellcode. D'Konfiguratiounsdatei enthält e Geheimnis, net e verschlësselte Vault.

Manuell Konfiguratioun oder Wiessel Ubidder

Ersetzen den Endpunkt hei drënner mam Wäert vum Dësch anMODEL_IDmat engem Modell an Ärem Provider Kont verifizéiert. Wann Äre Schlëssel schonn exportéiert ass alsGROQ_API_KEY, dëst Bash/zsh Beispill benotzt et ouni d'Geheimnis ze tippen:

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

Fëschequivalent:

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"

Fir Gemini oder OpenRouter, benotzt hir Endpunkt an unerkannt Schlësselvariabel amplaz. Späichert déi gewielte Astellunge sécher fir zukünfteg Shells. Cloud Endpunkte verlaangen HTTPS an en Token; lokal HTTP ass keng Ofkiirzung fir e Cloud Service. Kucktd'Ëmwelt Referenzananer ënnerstëtzt Providerfir bezuelte Servicer an fortgeschratt Iwwerschreiden.

Skriptinstallatioun: eng Alternativ, net déi éischt Wiel

Preferenz Homebrew, APT, DNF oder Pacman: si verfollegen Besëtzer Dateien, verifizéieren Downloads mat hirer Vertrauenskonfiguratioun a liwweren vertraute Updates / Entfernung. Si erfuerderen nach ëmmer vertrauenswürdege Verëffentlecher a Paketinstallatiounsaktiounen.

Viraussetzunge: eng ënnerstëtzt OS / Architektur,$SHELLidentifizéieren Bash / zsh / Fësch,Sigstore cosign,tar,uname,install, Standard Shell Utilities, e SHA-256 Kommando (sha256sum,shasum, odersha256), an en Downloader (curl,wgetoder Python). D'Beispill benotzt Curl. FreeBSD brauch och Bash. Ären Heem / Installatiounsverzeichnis muss schreiwenbar sinn.

Eroflueden op eng lokal Datei, kontrolléiert et mat engem Editor, an ausféiert nëmmen wann Dir seng Quell a Verhalen vertraut. Inspektioun ass keng Garantie fir Sécherheet; lafen dës Schrëtt net blann aus:

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

No der Inspektioun, lafen déi gespäichert Kopie als Ären normale Benotzer:

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

install.shLuet déi lescht Verëffentlechung erof, verifizéiert säi Sigstore-ënnerschriwwene Checksum Manifest an Archivverdauung, an installéiertash/ash-brokeran~/.local/bin. Native Plugins ginn ënner$XDG_DATA_HOME/ash/plugins. Et leeft pro Benotzer Setup a freet ier d'Shell Integratioun aktivéiert. Ouni en interaktiven Terminal kënnen d'Provider / Integratiounsprompts iwwersprongen ginn: lafenash installinteraktiv duerno.

Dir kënnt setzenASH_INSTALL_DIRier Dir de Skript leeft fir eng aner Destinatioun ze wielen. Füügt dës Destinatioun op PATH selwer.Self-Update gëtt nëmmen ënner ënnerstëtzt~/.local/bin; Benotzerdefinéiert Destinatiounen erfuerderen manuell Ersatz. De Skript huet kee Beta / Nightly Selector.

Verifizéiert en direkten Package oder Archiv

Viraussetzunge: Cosign an e SHA-256 Utility. Vun der selwechter publizéierter Verëffentlechung, luet Äre Package / Archiv erof,SHA256SUMS,an anSHA256SUMS.sigstore.json. Schafft an engem neie Verzeechnes. ErsetzenvX.Y.Zmam genauen Tag, mat engem Prerelease Suffix, wann zoutreffend:

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"

Eréischt nodeems dat geléngt, berechnen Äre Fichier Verdauung matshasum -a 256 PACKAGEop macOS,sha256sum PACKAGEop Linux, odersha256 -q PACKAGEop FreeBSD. ErsetzenPACKAGEmam erofgeluede Dateinumm a vergläicht et genau mat deem Dateinumm seng Entrée am verifizéierte Manifest. Stop op engem vermësst Entrée oder all Mëssverständnis. En net ënnerschriwwene Checksum, deen nieft engem Fichier erofgeluede gëtt, ass net gläichwäerteg mat verifizéierte Verëffentlecher Metadaten.

Aktualiséierungen an déi dräi Channels

• Verëffentlechung (recommandéiert):stabil publizéiert Versiounen wéivX.Y.Z; Repository Konfiguratioun nennt dëststable.
• Beta:Prerelease Testen, taggedvX.Y.Z-beta.N; erwaarden Ännerungen an regressions.
• Nuecht:rezent Standard-Branch Ännerungen, taggedvX.Y.Z-nightly.YYYYMMDD.N; héchste Réckgang Risiko. Builds si geplangt awer kënne iwwersprangen ginn wann näischt ännert oder d'Verëffentlechung feelt.

Eng verëffentlecht Verëffentlechung aktualiséiert déi entspriechend Homebrew Formel oder ënnerschriwwen Linux Repository. Dir kritt et wann Dir den Upgrade Kommando vum Besëtzer Manager leeft (oder Är eege OS Update Politik mécht). Verëffentlechung, Repositoryupdates, a Websäit Deployment kënne sech géigesäiteg halen; iwwerpréift Disponibilitéit ier Dir Channels ännert. ash installéiert net roueg Hannergrond binär Aktualiséierungen.

Homebrew: installéieren oder Formulen schalt

Fir eng frësch Beta/Nightly Installatioun, benotzt den entspriechende vollen Formelnumm uewen am brew install. Wann Dir wiesselt, deinstalléiert fir d'éischt déi aktuell installéiert Formel: all dräi liwweren déiselwecht Binären. Beispill, Verëffentlechung op Beta:

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

Benotztash-nightlyfir Nightly oderashfir Verëffentlechung an den Installatioun / Upgrade Kommandoen. Deinstalléiert déi aktuell Formel vum alen Kanal, net ëmmerash. Benotzer Astellunge behalen; oppen eng nei Réibau nom Wiessel.

Linux: wielt ee Repository Kanal

APT:benotzen derAPT Setupmat genee eng Verdeelung vum Dësch. Fir eng existent Installatioun ze wiesselen, änneren/etc/apt/sources.list.d/versionx.list, ersetzenstablematbetaodernightly(oder zréck opstable), dann:

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

DNF:benotzen derDNF Setupmat der gewielter baseurl. Fir eng existent Installatioun, ersetzenbaseurlan/etc/yum.repos.d/versionx.repo, hält seng Ënnerschrëft Astellungen, dann:

sudo dnf --refresh distro-sync ash

Pacman:benotzen derPacman Setupmat der gewielter Server URL. Halt den Numm vun der Rubrik[versionx]: all Kanal publizéiert eng Datebank mam Nummversionx.db. Ännert de Server an deem engen Abschnitt anstatt eng aner benannt Datebank ze addéieren. Fir ze wiesselen, dorënner en Downgrade:

sudo pacman -Syuu ash

Iwwerpréift déi proposéiert Transaktioun: zréck op d'Verëffentlechung kann ash downgrade, an dem Pacman seng duebel u kann och aner Packagen downgradéieren. Backup vun der Konfiguratioun virum Wiessel. Duerno benotzt normal APT / DNF / Pacman Upgrade Kommandoen aus den OS Sektiounen; loosst e puer ash Kanalquellen net aktivéiert.

Benotzerlokal Verëffentlechungsupdates

ash update

Dëst verifizéiert an installéiert eng stabil Verëffentlechung nëmmen wann déi aktivashausféierbar ass ënner~/.local/bin. Et aktualiséiert och gebündelt Verméigen / Plugins, mat Wiel fir personaliséiert Dateien.ash update --version vX.Y.Zwielt e stabile Tag, net e Kanal; et ass keen Downgrade Kommando. Et gëtt keng--channelOptioun. Package-Manager installs, macOS .pkg installs, a personaliséiert Skript Destinatiounen mussen amplaz hire Besëtzer Manager/Installateur benotzen. FreeBSD Beta / Nightly benotzt manuell verifizéiert Archiven, net e Selbstaktualiséierungsabonnement. Öffnen eng nei Shell nom Update.

Deinstalléieren ouni onrelatéiert Dateien ze läschen

1. Desaktivéiere vun der Shell Integratioun als éischt

Ier Dir Binäre läschen, fuert de Kommando fir all Shell wou Dir Integratioun aktivéiert hutt:

Bash

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

zsh

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

Fësch

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

Wannashscho fehlt, ännert déi entspriechend Startupdatei vuninitializationan ewechzehuelen nëmmen de Spär tëscht# >>> ash install >>>an# <<< ash install <<<. Ewechzehuelen allash-spezifesch PATH / Ëmwelt Linnen Dir manuell dobäi, net unrelated Shell Configuratioun. Zoumaachenash-aktivéiert Shells duerno sou datt hir Shell-Besëtzer Broker erausgoen.

2. Loosst de Besëtzer Package Manager seng Dateien ewechhuelen

Homebrew (Verëffentlechung)

brew uninstall ash

APT

sudo apt remove ash

DNF

sudo dnf remove ash

Pacman

sudo pacman -R ash

Wielt nëmmen Är Installatiounsmethod; fir Homebrew Beta / Nuecht benotzenash-beta/ash-nightly. APT / DNF / Pacman ewechhuelen Package-Besëtz Binären, Plugins, a Mann Säiten, net Är Heemverzeichnis Konfiguratioun / Geschicht. Net manuell Package-Besëtz Dateien läschen.

Optional Repository Botzen: ewechhuelenashQuelldatei/etc/apt/sources.list.d/versionx.lista seng engagéiert/etc/apt/keyrings/versionx-keyring.gpg, oder denashRepository Datei/etc/yum.repos.d/versionx.repo, oder denash [versionx]Abschnitt aus/etc/pacman.conf. Kontrolléiert éischt datt keng aner Packagen se benotzen. Ewechzehuelen en importéiert RPM / Pacman Vertrauensschlëssel nëmmen nodeems de Fangerofdrock bestätegt huet an datt näischt anescht drop hänkt; läscht ni eng Verdeelung gedeelt Schlësselring.

3a. Manuell macOS .pkg Ewechhuele

macOS Installer registréiert eng Empfang awer huet kengashuninstaller. Bestätegt datt dëst eng .pkg Installatioun ass, net Homebrew, a kontrolléiert seng exakt Notzlaascht:

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

Benotzt dës Empfang als Inventar, läscht nëmmen sengash- Besëtz Dateien:/usr/local/bin/ash,/usr/local/bin/ash-broker, d'Dateien an/usr/local/lib/ash/plugins,/usr/local/share/man/man1/ash.1, der opgezielt lokaliséiertash.1Säiten, an Uschléi an/usr/local/share/licenses/ash. Administrator Privilegien sinn néideg. Préift d'Eegentum wann en aneren Installateur dës Dateien duerno ersat huet; ewechzehuelen net seng Kopie. Ewechzehuelen eidelash-nëmmen Verzeechnes, net gedeelt/usr/local,bin, oder Mann Verzeechnes.

Nodeems Dir d'Notzlaascht geläscht hutt, läscht optional d'Empfang:

sudo pkgutil --forget dev.ash.cli

Eng Empfang vergiessen läscht keng installéiert Dateien.Späichert et bis Dir d'Notzlaascht iwwerpréift hutt.

3b vun. Manuell Benotzer-lokal / Linux / FreeBSD Archiv Entfernung

Situéiert der aktiv Kopie matcommand -v ashancommand -v ash-broker. Fir d'Standard Skriptinstallatioun, nodeems Dir Haken deaktivéiert hutt, läscht dës zwee spezifesch Dateien:

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

FirASH_INSTALL_DIRoder e manuell extrahéierten Archiv, ewechzehuelen nëmmen déi aktuell installéiertash/ broker Weeër. Ewechzehuelen Archiv Plugins / Mann Säiten / Notifikatiounen Dir installéiert Är original Fichier Inventar benotzt; Skript Plugins sinn an derashBenotzer-Daten Verzeechnes. Wann Dateien ënner sinn/usr/bin, Check Proprietairen éischt matdpkg -S /usr/bin/ash,rpm -qf /usr/bin/ash, oderpacman -Qo /usr/bin/ashwéi passend. E Paket-Besëtzer Kopie muss duerch dee Manager geläscht ginn, och wann se vun engem Standalone Download installéiert sinn.

4. Optional: lokal Astellungen, Tools a Geschicht läschen

• Konfiguratioun:$XDG_CONFIG_HOME/ash, Default~/.config/ash.
• Daten, Plugins a Python Ëmfeld:$XDG_DATA_HOME/ash, Default~/.local/share/ash.
• Geschicht a Staat:$XDG_STATE_HOME/ash, Default~/.local/state/ash.
• Cache:$XDG_CACHE_HOME/ash, Default~/.cache/ash.
• Broker Runtime:$XDG_RUNTIME_DIR/ash, oder$XDG_STATE_HOME/ash/runtimewann keng Runtime Root verfügbar ass.

Kontrolléiert Är aktuell absolut XDG Iwwerschreiden ier Dir nëmmen dës ash Ënnerverzeechnungen läscht; läscht ni en XDG Root oder Ären Heemverzeechnes. Nodeems all ash-aktivéiert Shells zougemaach hunn, ewechzehuelen Reschter ash Runtime Dateien wann néideg. MCP OAuth Umeldungsinformatiounen kënnen och am OS Umeldungsmanager bleiwen: ewechzehuelen ash-spezifesch Entréen do an zréckzéien Zougang zu der MCP Provider. Onbenotzt AI Schlësselen an hire Providerkonten zréckzéien; eng lokal Datei läschen hëlt kee Schlëssel zréck. Deinstalléiert net Ollama / Modeller, Python oder gedeelt Ofhängegkeeten als Deel vun der ash Entfernung.

Schnell Troubleshooting

Kommando net fonnt oder falsch Versioun

Check PATH ancommand -v ash/command -v ash-broker. Eng al~/.local/binKopie kann e Package schatten. Benotzt ee Besëtzer / Kanal gläichzäiteg an oppen eng nei Shell.

Provider Menü schéngen net

Lafenash installvun engem interaktiven Terminal. Bestehend valabel Astellunge sinn erhaalen; benotzenmanuell ConfiguratiounProvider ze wiesselen. Ouni Integratioun, vergewëssert Iech datt d'Astellungen an d'Ëmfeld vum CLI exportéiert ginn.

Kee Modell oder Verbindung refuséiert

Fir Ollama, confirméieren sengem Server leeft anollama listenthält Äre gewielte Modell. Fir Cloud-Servicer, kontrolléiert Endpunkt, Modellberechtegung, HTTPS, Token a Kontquot; deelen ni Token-Träger Logbicher.

Repository oder Kanal net verfügbar

Iwwerpréift d'Architektur an de publizéierten Release / Repository. Publikatioun kann lags; deaktivéiert d'Ënnerschrëftverifizéierung net fir ronderëm en net verfügbare Repository ze schaffen.

Python Tool Setup ass gescheitert

Installéiert Python mat venv / ensurepip an erlaabt Ofhängegkeet Downloads, da rerunash install. Basisashbleift benotzbar ouni dës Tools.

Braucht Dir méi Detailer? Kucktde Kommando Referenz,FAQ, odere Problem mellenouni Umeldungsinformatiounen.