Una ruta clara hacia
su primer mensaje.

Antes de comenzar

1. Un sistema y shell compatibles: macOS o Linux en amd64/x86_64 o arm64/aarch64, o FreeBSD en amd64. Utilice Bash, zsh o Fish. Los paquetes de Arch son solo x86_64. No hay un instalador nativo de Windows/PowerShell.
2. Acceso de descarga: una conexión a Internet que funcione y acceso HTTPS confiable a GitHub, el repositorio de paquetes seleccionado y su proveedor de modelo. La inferencia local aún necesita una descarga del modelo inicial.
3. Permisos: un directorio de inicio grabable para recursos por usuario. Los paquetes del sistema Linux y macOS .pkg necesitan acceso de administrador; ejecute Homebrew y ash install como su usuario normal.
4. Un modelo: ya sea un servidor de inferencia local con un modelo descargado o una cuenta de nube/clave API. Elija un modelo que admita la llamada de herramientas, no un modelo de solo imagen/audio. Las necesidades de RAM, disco y GPU locales dependen de ese modelo.

Los paquetes prediseñados ash no requieren herramientas de compilación Go, Rust, Node.js o Xcode. Un administrador de paquetes puede tener sus propios requisitos previos; Siga primero las instrucciones de configuración oficiales.

macos

Recomendado: cerveza casera

Requisitos previos:cerveza casera, su entorno macOS compatible y un sistema operativobrewdominio. El toque selecciona automáticamente el archivo Intel o Apple Silicon. Homebrew 6 no confía implícitamente en este grifo de terceros. Si Homebrew se niega a cargar la fórmula como no confiable, revise el editor y la fórmula, luego confíe solo en esta fórmula (no en todo el grifo):

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

Homebrew recuerda esta decisión de fideicomiso local. El grifo no puede generar confianza en su nombre; confiando en todo el grifobrew trust jonconradt/ashes más amplio y permite cargar también sus otras fórmulas. Para confiar en Beta o Nightly, utilice el nombre de fórmula correspondiente,jonconradt/ash/ash-betaojonconradt/ash/ash-nightly. Homebrew es propietario de los archivos binarios, los complementos nativos incluidos, las páginas de manual y los avisos de licencia en su prefijo (normalmente/opt/homebrewen Apple Silicon o/usr/localen Intel). Comprueba el archivo con la suma de comprobación SHA-256 de la fórmula. No configura su proveedor ni edita su archivo de inicio de shell: continúe coninicialización por usuario. Usarbrew upgrade ashpara actualizaciones ybrew uninstall ashpara eliminar Liberación; verfórmulas de canalpara Beta/Nocturno.

Alternativa: .pkg nativo

Descarga eldarwin-arm64.pkgactivo para Apple Silicon odarwin-amd64.pkgpara Intel desde unlanzamiento publicado.Verifique su manifiesto de suma de verificación firmadoantes de abrir el instalador. Se requiere acceso de administrador.

El paquete escribeashyash-brokera/usr/local/bin, complementos para/usr/local/lib/ash/plugins, páginas man a/usr/local/share/many avisos a/usr/local/share/licenses/ash. El recibo esdev.ash.cli. No ejecuta inicialización por usuario ni se suscribe a actualizaciones:inicializardespués de la instalación, reemplácelo con un .pkg más nuevo verificado para actualizar y use elprocedimiento de eliminación manualpara desinstalar. No lo instale sobre una copia propiedad de Homebrew.

linux

Utilice el administrador de paquetes de su distribución siempre que sea posible. Estos paquetes poseen/usr/bin/ash,/usr/bin/ash-broker,/usr/lib/ash/plugins, páginas man bajo/usr/share/many avisos de licencia. Dejan la configuración del proveedor y los enlaces de shell ainicialización por usuario.

Debian y Ubuntu: APT

Requisitos previos: amd64 o arm64, acceso de administrador, APT,curl,gpgy certificados de CA. Instale las herramientas clave/descarga que faltan usando su distribución antes de agregar el repositorio. La liberación se llamastable:

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

Antes de importar cualquier clave de repositorio, verifique su huella digital con una fuente de editor confiable. La huella digital de la clave VersionX es32C6 C11D 2F86 BFE4 6EB7 7FFC 5257 FEA6 1368 919F. APT verifica los metadatos del repositorio firmados y los resúmenes del paquete que contiene; la clave tiene un alcance consigned-by. Actualizar consudo apt update && sudo apt upgrade ash; eliminar consudo apt remove ash.

Sistemas compatibles con Fedora y RHEL: DNF

Requisitos previos: x86_64 o aarch64, acceso de administrador, DNF/RPM,curl,gpgy certificados de CA. Instale las herramientas que faltan en su distribución. Inspeccione la clave y compare la huella digital anterior antes de importarla:

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

Los archivos RPM no están firmados individualmente.repo_gpgcheck=1verifica los metadatos del repositorio que cubren sus sumas de verificación;gpgcheck=0refleja las firmas ausentes por paquete, no la verificación del repositorio deshabilitada. Si su política requiere cargas útiles RPM firmadas, este repositorio no la cumple. Actualizar consudo dnf upgrade ash; eliminar consudo dnf remove ash.

Arco Linux: Pacman

Requisitos previos: x86_64, acceso de administrador, Pacman con su llavero inicializado,curl, ygpg. Verifique que la huella digital de la clave mostrada coincida con la anterior antes de confiar en ella. Agregue el repositorio una vez, no en cada actualización:

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 verifica las firmas de paquetes y bases de datos. Mantenga Arch sincronizado consudo pacman -Syu, no una actualización parcial; eliminarashconsudo pacman -R ash.

Otros métodos de instalación de Linux

Ya estoy usandoCerveza casera en Linux? Elmismas instrucciones de toquecompatible con amd64 y arm64; Brew es propietario de estos archivos, no de APT/DNF. De lo contrario, utilice un verificadoinstalación de script/archivoo una combinaciónDescarga .deb/.rpm. Instale un .deb verificado consudo apt install ./PACKAGE.deb, o un .rpm consudo dnf install ./PACKAGE.rpm(reemplace los nombres de archivos). Un paquete directo sigue siendo propiedad del administrador de paquetes, pero no agrega un repositorio ni se suscribe automáticamente a versiones futuras. La carga útil de RPM actual no está firmada; siga la política de su distribución en lugar de deshabilitar las comprobaciones de firmas.

FreeBSD

Requisitos previos: AMD64, Bash (incluso cuando su shell interactivo sea zsh o Fish), herramientas de descarga/verificación y un directorio de instalación grabable. Instale Bash usando el administrador nativo de FreeBSD:

sudo pkg install bash

FreeBSDpkggestiona los requisitos previos, noash: actualmente no hayashRepositorio .pkg y sin archivo de lanzamiento arm64. Utilice elguión verificado, overificar un archivo tar FreeBSD amd64, extráigalo en un directorio temporal e instale su versión versionada.ashbinario como~/.local/bin/ashjunto aash-broker. Copie sus complementos nativos a$XDG_DATA_HOME/ash/plugins(por defecto~/.local/share/ash/plugins), entoncesinicializar. Eres el propietario de estos archivos;pkg deleteno los eliminará. UsarPublicar actualizaciones automáticasen la ubicación predeterminada o reemplazar manualmente los artefactos verificados.

Inicializar y verificar

Después de instalar los binarios, ejecute la configuración de forma interactiva como su usuario normal. Si no desea la integración del shell, puede instalar solo Ash. Probablemente esto no sea lo que quieres. El valor real de ash es la integración del shell a continuación. La configuración de solo recursos no modifica los archivos de inicio:

ash install

La instalación que probablemente desee utilizar implica la integración del shell. Esto cambiará su .bashrc (o el equivalente de su shell) para incluir Ash. Para habilitar la integración de comando no encontrado, elija exactamente un comando para el shell que utiliza:

Bash

ash install --shell bash --shell-integration

zsh

ash install --shell zsh --shell-integration

Pescado

ash install --shell fish --shell-integration

usos de bash~/.bashrc, usos zsh~/.zshrcy usos del pescado$XDG_CONFIG_HOME/fish/config.fish(por defecto~/.config/fish/config.fish). Abra un nuevo shell después; los shells existentes conservan su intermediario en ejecución. La integración antepone~/.local/bina RUTA: elimine una copia local del usuario anterior antes de esperar que se seleccione un paquete del sistema.

Si falta la configuración del proveedor, la configuración detecta claves de proveedor existentes o un servidor local en ejecución; de lo contrario, ofrece un menú de proveedores y solicita credenciales. Elija un modelo disponible con capacidad para herramientas. Se conservan las configuraciones válidas existentes, por lo que volver a ejecutar la instalación no es un comando de cambio de proveedor.

Los ajustes se almacenan en$XDG_CONFIG_HOME/ash/.ash_env(por defecto~/.config/ash/.ash_env, permisos de archivos privados). La integración administrada los carga. Sin integración, los usuarios de Bash/zsh pueden obtener ese archivo en su configuración de inicio normal; Los usuarios de peces deben establecer el correspondienteASH_AI_*variables que utilizan la sintaxis de Fish, no generan el archivo en formato Bash. Proteja cualquier archivo que contenga tokens y nunca lo confirme.

Para una instalación local de usuario sin integración, agregue su directorio real a PATH. bash/zsh:export PATH="$HOME/.local/bin:$PATH". Pez:fish_add_path "$HOME/.local/bin". Persiste en esto usando la configuración de inicio de tu shell; sustituya su directorio de instalación personalizado cuando corresponda.

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

Los primeros comandos deberían resolverse en la instalación que eligió. El mensaje necesita un servidor en ejecución o credenciales de nube válidas; instalar ash no instala un modelo.

Ollama local: no se requiere cuenta en la nube

No necesitas tener una IA local para usarash. Sin embargo, si desea ejecutar modelos localmente sin depender de un proveedor de nube, puede configurar un servidor Ollama local.

Ollama también ofrece un servicio en la nube para ejecutar modelos de forma remota, pero no es necesario para el uso local conash. El servidor en la nube incluye un nivel gratuito y el modelo de nube Gemma 4 31b de Google (gemma4-31b:nube) funciona muy bien conash. Este es el modelo utilizado por el proyecto para generar notas de la versión y realizar tareas de desarrollo.

Instale Ollama usando suinstrucciones oficiales del sistema operativo. Inicie la aplicación/servicio Ollama o ejecúteloollama serveen una terminal separada si aún no se está ejecutando un servidor. En FreeBSD,ashEl soporte de no implica un instalador nativo de Ollama: use un servidor accesible en otro host compatible si es necesario.

Descargue un modelo compatible con herramientas que se adapte a su hardware;llama3.1:8bes un ejemplo, no un requisito mínimo. Compruebe elcatalogo de herramientas actualpara alternativas:

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

Sin claves de nube configuradas, la configuración puede detectar el servidor local y ofrecer el modelo descargado. Si ya hay otro proveedor configurado, cambie manualmente el punto final/modelo. Ejemplo de 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"

Equivalente de pescado:

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"

Estos cambios afectan sólo al shell actual. Persígalos en tu protegido.asharchivo de entorno o configuración de shell adecuada, reemplazando cualquier anulación de proveedor anterior. El local Ollama no necesita ficha. Mantenga el servidor en bucle invertido a menos que asegure el acceso deliberadamente; un servidor remoto recibe sus indicaciones y los resultados de la herramienta.

Opcional: establecerOLLAMA_KEEP_ALIVE=30men elServidor de Ollamaentorno y reinicie el servidor para mantener los modelos calientes.-1los mantiene cargados indefinidamente pero consume memoria entre solicitudes. Establecer esto sólo en elashEl terminal del cliente no reconfigura un servidor que ya se está ejecutando.

La inferencia local no tiene factura API del proveedor, pero utiliza su hardware/almacenamiento/electricidad.nube de llamaes un servicio independiente con autenticación y límites del plan; no es lo mismo que esta configuración local.

Niveles de nube gratuitos

Cree una clave de proveedor utilizando los enlaces siguientes, luego ejecute ash install de forma interactiva y elija ese proveedor. La configuración solicita el token y enumera los modelos donde son compatibles. Elija un modelo de texto con llamada de herramienta de nivel gratuito actualmente disponible; incluir un modelo no garantiza que sea gratuito para su cuenta.

¿Ya exporta una clave de proveedor reconocida? El programa de instalación lo detecta; si existen varias claves, le pedirá que elija. No pegue claves reales en el historial de comandos, grabaciones o código fuente. El archivo de configuración contiene un almacén secreto, no cifrado.

Configuración manual o cambio de proveedores

Reemplace el punto final a continuación con el valor de la tabla yMODEL_IDcon un modelo verificado en su cuenta de proveedor. Si su clave ya está exportada comoGROQ_API_KEY, este ejemplo de Bash/zsh lo reutiliza sin escribir el secreto:

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

Equivalente de pescado:

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"

Para Gemini u OpenRouter, utilice su punto final y la variable clave reconocida. Guarde la configuración elegida de forma segura para futuros shells. Los puntos finales en la nube requieren HTTPS y un token; HTTP local no es un atajo para un servicio en la nube. Verla referencia ambientalyotros proveedores compatiblespara servicios pagos y anulaciones avanzadas.

Instalación de scripts: una alternativa, no la primera opción

Prefiere Homebrew, APT, DNF o Pacman: rastrean los archivos de su propiedad, verifican las descargas usando su configuración de confianza y proporcionan actualizaciones/eliminación familiares. Todavía requieren editores confiables y acciones de instalación de paquetes.

Requisitos previos: un sistema operativo/arquitectura compatible,$SHELLidentificando Bash/zsh/Fish,aval de tienda de firmas,tar,uname,install, utilidades de shell estándar, un comando SHA-256 (sha256sum,shasum, osha256), y un descargador (curl,wget, o Python). El ejemplo usa curl. FreeBSD también necesita Bash. Su directorio de inicio/instalación debe poder escribirse.

Descárguelo en un archivo local, inspecciónelo con un editor y ejecútelo solo si confía en su fuente y comportamiento. La inspección no es garantía de seguridad; No ejecute estos pasos a ciegas:

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

Después de la inspección, ejecute la copia guardada como su usuario normal:

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

install.shdescarga la última versión, verifica su resumen de archivo y manifiesto de suma de comprobación firmado por Sigstore, e instalaash/ash-brokeren~/.local/bin. Los complementos nativos desaparecen$XDG_DATA_HOME/ash/plugins. Ejecuta la configuración por usuario y pregunta antes de habilitar la integración del shell. Sin una terminal interactiva, es posible que se omitan las indicaciones del proveedor/integración: ejecutarash installinteractivamente después.

Puedes configurarASH_INSTALL_DIRantes de ejecutar el script para elegir otro destino. Agregue ese destino a PATH usted mismo.La actualización automática solo se admite en~/.local/bin; los destinos personalizados requieren reemplazo manual. El script no tiene selector Beta/Nightly.

Verificar un paquete o archivo directo

Requisitos previos: cofirmante y una utilidad SHA-256. Desde la misma versión publicada, descargue su paquete/archivo,SHA256SUMS, ySHA256SUMS.sigstore.json. Trabajar en un nuevo directorio. ReemplazarvX.Y.Zcon la etiqueta exacta, incluido un sufijo previo al lanzamiento, si corresponde:

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"

Sólo después de que esto tenga éxito, calcule el resumen de su archivo conshasum -a 256 PACKAGEen MacOS,sha256sum PACKAGEen Linux, osha256 -q PACKAGEen FreeBSD. ReemplazarPACKAGEcon el nombre del archivo descargado y compárelo exactamente con la entrada de ese nombre de archivo en el manifiesto verificado. Deténgase si falta una entrada o si no coincide. Una suma de comprobación sin firmar descargada junto a un archivo no equivale a metadatos de editor verificados.

Actualizaciones y los tres canales

• Lanzamiento (recomendado):versiones publicadas estables comovX.Y.Z; la configuración del repositorio llama a estostable.
• Beta:pruebas previas al lanzamiento, etiquetadovX.Y.Z-beta.N; esperar cambios y regresiones.
• Nocturno:cambios recientes en la rama predeterminada, etiquetadosvX.Y.Z-nightly.YYYYMMDD.N; el mayor riesgo de regresión. Las compilaciones están programadas, pero pueden omitirse si nada cambia o falla la publicación.

Una versión publicada actualiza la fórmula Homebrew correspondiente o el repositorio de Linux firmado. Lo recibe cuando ejecuta el comando de actualización del administrador propietario (o lo hace su propia política de actualización del sistema operativo). La publicación, las actualizaciones del repositorio y la implementación del sitio web pueden retrasarse entre sí; Consulta disponibilidad antes de cambiar de canal. ash no instala silenciosamente actualizaciones binarias en segundo plano.

Homebrew: instalar o cambiar fórmulas

Para una nueva instalación Beta/Nightly, use el nombre completo de la fórmula correspondiente arriba en brew install. Al cambiar, primero desinstale la fórmula instalada actualmente: los tres proporcionan los mismos archivos binarios. Ejemplo, lanzamiento a Beta:

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

Usarash-nightlypara todas las noches oashpara lanzamiento en los comandos de instalación/actualización. Desinstalar la fórmula real del canal antiguo, no siempreash. La configuración del usuario se conserva; abra un nuevo shell después de cambiar.

Linux: seleccione un canal de repositorio

APTO:utilizar elconfiguración APTcon exactamente una distribución de la tabla. Para cambiar una instalación existente, edite/etc/apt/sources.list.d/versionx.list, reemplazandostableconbetaonightly(o volver astable), entonces:

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

abandono:utilizar elConfiguración DNFcon la URL base seleccionada. Para una instalación existente, reemplacebaseurlen/etc/yum.repos.d/versionx.repo, manteniendo su configuración de firma, luego:

sudo dnf --refresh distro-sync ash

Pacman:utilizar elConfiguración de Pacmancon la URL del servidor seleccionada. Mantener el nombre de la sección[versionx]: cada canal publica una base de datos llamadaversionx.db. Cambie el servidor en esa sección en lugar de agregar una base de datos con un nombre diferente. Para cambiar, incluida una degradación:

sudo pacman -Syuu ash

Revise la transacción propuesta: regresar a la versión puede degradar ash, y el doble de Pacman u también puede degradar otros paquetes. Haga una copia de seguridad de la configuración antes de cambiar. Luego use los comandos de actualización normales de APT/DNF/Pacman desde las secciones del sistema operativo; no deje varias fuentes de canal ash habilitadas.

Actualizaciones de la versión local del usuario

ash update

Esto verifica e instala una versión estable solo cuando el activoashejecutable está bajo~/.local/bin. También actualiza los activos/complementos incluidos, con opciones para archivos personalizados.ash update --version vX.Y.Zselecciona una etiqueta estable, no un canal; no es un comando de degradación. no hay--channelopción. Las instalaciones del administrador de paquetes, las instalaciones .pkg de macOS y los destinos de scripts personalizados deben utilizar su administrador/instalador propietario. FreeBSD Beta/Nightly utiliza archivos verificados manualmente, no una suscripción de actualización automática. Abra un nuevo shell después de la actualización.

Desinstalar sin eliminar archivos no relacionados

1. Primero deshabilite la integración del shell

Antes de eliminar archivos binarios, ejecute el comando para cada shell en el que haya habilitado la integración:

Bash

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

zsh

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

Pescado

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

Siashya falta, edite el archivo de inicio relevante desdeinicializacióny retire sólo el bloque entre# >>> ash install >>>y# <<< ash install <<<. Eliminar cualquierash-líneas de RUTA/entorno específicas que agregó manualmente, no configuración de shell no relacionada. Cercaash-habilitó los shells posteriormente para que sus intermediarios propiedad del shell salgan.

2. Deje que el administrador de paquetes propietario elimine sus archivos.

Cerveza casera (lanzamiento)

brew uninstall ash

APTO

sudo apt remove ash

Abandono

sudo dnf remove ash

Pacman

sudo pacman -R ash

Elija sólo su método de instalación; para Homebrew Beta/uso nocturnoash-beta/ash-nightly. APT/DNF/Pacman elimina los archivos binarios, complementos y páginas de manual propiedad del paquete, no la configuración/el historial de su directorio de inicio. No elimine manualmente los archivos propiedad del paquete.

Limpieza de repositorio opcional: elimine elasharchivo fuente/etc/apt/sources.list.d/versionx.listy su dedicado/etc/apt/keyrings/versionx-keyring.gpg, o elasharchivo del repositorio/etc/yum.repos.d/versionx.repo, o elash [versionx]sección de/etc/pacman.conf. Primero verifique que ningún otro paquete los use. Elimine una clave de confianza RPM/Pacman importada solo después de confirmar su huella digital y que nada más dependa de ella; nunca elimine el conjunto de claves compartido de una distribución.

3a. Eliminación manual de .pkg de macOS

El instalador de macOS registra un recibo pero no tieneashdesinstalador. Confirme que se trata de una instalación .pkg, no de Homebrew, e inspeccione su carga útil exacta:

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

Usando ese recibo como inventario, retire sólo suash-archivos de propiedad:/usr/local/bin/ash,/usr/local/bin/ash-broker, los archivos en/usr/local/lib/ash/plugins,/usr/local/share/man/man1/ash.1, el listado localizadoash.1páginas y avisos en/usr/local/share/licenses/ash. Se necesitan privilegios de administrador. Verifique la propiedad si otro instalador reemplazó estos archivos posteriormente; no elimine su copia. Quitar vacíoash-solo directorios, no compartidos/usr/local,bin, o directorios man.

Después de eliminar la carga útil, opcionalmente elimine el recibo:

sudo pkgutil --forget dev.ash.cli

Olvidar un recibo no elimina ningún archivo instalado.Consérvelo hasta que haya terminado de comprobar la carga útil.

3b. Eliminación manual de archivos local de usuario/Linux/FreeBSD

Localice la copia activa concommand -v ashycommand -v ash-broker. Para la instalación del script predeterminado, después de deshabilitar los enlaces, elimine esos dos archivos específicos:

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

ParaASH_INSTALL_DIRo un archivo extraído manualmente, elimine sólo el archivo realmente instaladoash/rutas de intermediario. Elimine los complementos de archivo/páginas de manual/avisos que instaló utilizando su inventario de archivos original; Los complementos de script están en elashdirectorio de datos de usuario. Si los archivos están bajo/usr/bin, verifique la propiedad primero condpkg -S /usr/bin/ash,rpm -qf /usr/bin/ash, opacman -Qo /usr/bin/ashsegún corresponda. Una copia propiedad del paquete debe eliminarse a través de ese administrador, incluso si se instala desde una descarga independiente.

4. Opcional: borrar la configuración, las herramientas y el historial locales

• Configuración:$XDG_CONFIG_HOME/ash, por defecto~/.config/ash.
• Datos, complementos y entorno Python:$XDG_DATA_HOME/ash, por defecto~/.local/share/ash.
• Historia y estado:$XDG_STATE_HOME/ash, por defecto~/.local/state/ash.
• Cache:$XDG_CACHE_HOME/ash, por defecto~/.cache/ash.
• Tiempo de ejecución del corredor:$XDG_RUNTIME_DIR/ash, o$XDG_STATE_HOME/ash/runtimecuando no hay raíz de tiempo de ejecución disponible.

Inspeccione sus anulaciones XDG absolutas reales antes de eliminar solo estos subdirectorios ash; nunca elimine una raíz XDG o su directorio de inicio. Después de que se hayan cerrado todos los shells habilitados para ash, elimine los archivos de tiempo de ejecución ash sobrantes si es necesario. Las credenciales de MCP OAuth también pueden permanecer en el administrador de credenciales del sistema operativo: elimine las entradas específicas de ash allí y revoque el acceso en el proveedor de MCP. Revocar las claves AI no utilizadas en sus cuentas de proveedor; eliminar un archivo local no revoca una clave. No desinstale Ollama/models, Python ni las dependencias compartidas como parte de la eliminación de ash.

Solución rápida de problemas

Comando no encontrado o versión incorrecta

Marque RUTA ycommand -v ash/command -v ash-broker. un viejo~/.local/binLa copia puede seguir un paquete. Utilice un propietario/canal a la vez y abra un nuevo shell.

El menú del proveedor no apareció.

Correrash installdesde una terminal interactiva. Se conservan las configuraciones válidas existentes; usarconfiguración manualpara cambiar de proveedor. Sin integración, asegúrese de que la configuración se exporte al entorno de la CLI.

Ningún modelo o conexión rechazada

Para Ollama, confirme que su servidor esté funcionando yollama listIncluye el modelo elegido. Para servicios en la nube, verifique el punto final, la elegibilidad del modelo, HTTPS, token y cuota de cuenta; nunca comparta registros que contengan tokens.

Repositorio o canal no disponible

Verifique la arquitectura y la versión/repositorio publicado. La publicación puede retrasarse; No desactive la verificación de firmas para solucionar un repositorio no disponible.

Error en la configuración de la herramienta Python

Instale Python con venv/ensurepip y permita descargas de dependencias, luego vuelva a ejecutarash install. Básicoashsigue siendo utilizable sin estas herramientas.

¿Necesitas más detalles? Verla referencia del comando,Preguntas frecuentes, oreportar un problemasin credenciales.