ashDokumentatioun

Installéiert op Debian oder Ubuntu

Kuckt deAPT Installatioun Guidefir Viraussetzunge, Ënnerschreiwe Schlësselen, Repository Setup, Channels, Updates an Entfernung.

Installéiert op Fedora oder RHEL-kompatibel Linux

Kuckt deDNF Installatioun Guidefir Viraussetzungen, Metadatenverifizéierung, Repository Setup, Channels, Updates an Entfernung.

Installéiert op Arch Linux

Kuckt dePacman Installatioun Guidefir Viraussetzunge, Schlësselverifizéierung, Repository Setup, Channels, Updates an Entfernung.

Synopsis

ash [text ...]
ash install [--shell bash|zsh] [--dry-run] [--overwrite]
ash mcp add <url> [--no-browser]
ash snooze [duration|off]
ash update [--version vX.Y.Z] [--yes|--skip-customized]

Beschreiwung

ashschéckt prompt Text un de konfiguréierten AI Endpunkt an dréckt d'Assistent-Äntwert. Wann keen Positiounstext gëtt,ashliest prompt Text vun net-interaktiven Standardinput.

Déiinstallsubcommand installéiert geréiert Verméigen. Shell Startupdateien ginn nëmme geännert wann Dir explizit ufrot--shell-integration; Bash benotzt~/.bashrc, zsh benotzt~/.zshrc, a Fësch benotzt$XDG_CONFIG_HOME/fish/config.fish.

Verbindunge mam AI Provider ginn duerch e lokale Broker gedeelt. Broker Echec fällt zréck op direkt HTTPS.

D'AI kann systemd benotzen fir Hannergrond Aufgaben ze plangen. Dëst kënne widderhuelend oder eemoleg Aarbechtsplaze sinn. Geplangte Aarbechtsplaze benotze Standard HTTPS direkt.

ashfolgendermoossen XDG Basis Verzeichnisser: Configuratioun an bestänneg Aarbechtsberäich Fichieren ënner$XDG_CONFIG_HOME/ash(Standard~/.config/ash), Tools a Plugins ënner$XDG_DATA_HOME/ash(Standard~/.local/share/ash), Geschicht a Sessioun kraazt ënner$XDG_STATE_HOME/ash(Standard~/.local/state/ash), an de Cache ënner$XDG_CACHE_HOME/ash(Standard~/.cache/ash). Broker Sockets benotzen$XDG_RUNTIME_DIR/ashmat engem Staatsverzeichnis Réckfall. Explizit XDG Weeër mussen absolut sinn.

Tool, Skript, Datei, Pipeed, a Kanneroutput sinn net zouverléisseg Donnéeën a däerfen net System oder Benotzerinstruktiounen iwwerschreiden. D'Tool Ausféierung Feature ass keng Sandkëscht wann arbiträr Python oder Shell Ausféierung aktivéiert ass. Par défaut ass Python aktivéiert, also passt op.

Remote MCP Serveren

MCP (Model Context Protocol) Servere bidden Tools en AI Modell kann uruffen.Ashënnerstëtzt Remote Streamable HTTP MCP Serveren an hält hir Client Sessiounen anash-brokeriwwerAshOpruff an der selwechter Schuel.

Registréiert e vertrauenswürdege Server andeems Dir lafenash mcp add <url>vun engem interaktivenAshShell, oder andeems se seng URL derbäisetzen$XDG_CONFIG_HOME/ash/.ash_allow(Standard~/.config/ash/.ash_allow). Kee Remote Server ass par défaut aktivéiert.

OAuth Autorisatioun mécht am Desktop Browser op wann e GUI verfügbar ass. Wann de Browser net opgemaach ka ginn,Ashdréckt eng kopéierbar Autorisatiouns-URL aus a waart am Terminal. Benotztash mcp add <url> --no-browserfir ëmmer dësen Terminalflow ze benotzen. Manuell URL Autorisatioun erfuerdert nach ëmmer e Browser um selwechten Host; et ass keen browserlosen OAuth Flow.

URL Linnen ugefaange mathttp://oderhttps://sinn MCP Aschreiwungen, net Shell Kommandoen. Schemae ginn case-onsensibel unerkannt.Ashofgeleet de lokalen Numm vum Server vun den éischten 8 kleng hexadezimal Zeeche vun SHA-256 iwwer den ofgeschniddenen URL Text. HTTPS ass erfuerderlech ausser fir localhost Entwécklung; URLen mat embedded Umeldungsinformatiounen, Ufro Strings oder Fragmenter ginn ofgeleent. Fir direkt OAuth Verbindungen erlaabt Entdeckung Net-ëffentlech IP Adressen nëmme fir déi exakt registréiert MCP Autoritéit; aner OAuth-Host bleiwen ënner net-ëffentlech-Adress-Blockéierung. E konfiguréierten Egress Proxy ass verantwortlech fir seng Destinatiounsadressen ze filteren. Ännerungen ginn op der nächster geliesAshufroen.

MCP Aschreiwungen bleiwen aktivéiert matASH_STRICT=1. Zréckgeschéckt Outil Output gëtt ëmmer nach als net zouverlässeg Beweiser behandelt. Registréiert nëmmen Serveren déi Dir vertraut: hir Tools kënnen Handlungen aus Ärem Numm maachen. Fir OAuth-geschützte Serveren,Ashmécht de Browser op wann e GUI verfügbar ass, während de Broker den Callback an Tokens handhabt. Umeldungsinformatiounen benotzen den OS Umeldungsmanager wann verfügbar, oder eng verschlësselte Datei geschützt vun engem Benotzer geliwwert zoufälleg 32-ByteASH_MCP_CREDENTIAL_KEYan$XDG_DATA_HOME/ash/mcp/.

Wann d'MCP Initialiséierung feelt,Ashsetzt d'Ufro weider ouni Remote MCP Tools. Interaktiv leeft Drécken eng Warnung; net-interaktiv Lafen versoen roueg.Geplangte Aarbechtsplazen hunn net de per-interaktiven-Shell Broker an dofir kënnen d'Remote MCP Tools net benotzen.Eng geplangte Prompt, déi vum MCP ofhängt, kann nach lafen, awer kann ouni déi ugefrote MCP-Aktioun oder Daten fäerdeg sinn. Zäitplang keng Ufroen déi MCP erfuerderen.

Kuckt deMCP FAQfir e séieren Iwwerbléck a Setupnotizen.

Kommandoen

ash [--attach path]... [text ...]

Run eng eenzeg Assistent Ufro.--attachbefestegt e Fichier (Bild oder Dokument) un d'Ufro; widderholl. Gréisst-limitéiert vunASH_ATTACHMENT_MAX_BYTESan am Moment op den Drot geschéckt nëmmen OpenAI-kompatibel Ubidder.

ash mcp add <url> [--no-browser]

Connectéiert a registréiert e Remote MCP Server an der effektiver.ash_allow. Öffnet OAuth Autorisatioun an engem Desktop Browser wann verfügbar; fällt zréck op eng kopéierbar URL am Terminal.--no-browserbenotzt ëmmer den Terminalfloss.

ash install [--shell bash|zsh|fish] [--shell-integration|--disable-shell-integration] [--dry-run]

Installéiert Verméigen ouni Shell Startupdateien als Standard z'änneren.--shell-integrationoptéiert fir de verwaltete Block derbäi ze ginn / ze aktualiséieren;--disable-shell-integrationläscht nëmmen dee Spär a bewahrt ëmginn Benotzerinhalt. Wann interaktiv, installéieren Auto-configuresASH_AI_ENDPOINT,ASH_AI_MODEL,an anASH_AI_AUTH_TOKENwann néideg, léiwer eng bestehend Provider Schlëssel oder lokal Ennpunkt virun engem Provider Menü weist.

ash snooze [duration|off]

Paus automatesch Shell Prompt Veraarbechtung. De Standard ass fënnef Minutten. Dauer benotzen Go Syntax wéi30s,5m, oder1h. Benotztofffir direkt erëmzefannen.

ash update [--version vX.Y.Z] [--yes|--skip-customized]

Eroflueden an installéieren déi lescht stabil MacOS, Linux oder FreeBSD Verëffentlechung fir déi aktuell Architektur an~/.local/bin/ash. Verëffentlechungen erfuerderen Sigstore Verifikatioun an SHA-256 Verifikatioun.

Ëmwelt

ASH_AI_AUTH_TOKEN

Optional Bearer Token. Néideg fir Cloud Endpunkte ausser AWS Bedrock. Privat / LAN Adressen an.localHostnumm ginn als Net-Cloud behandelt ausserASH_STRICT=1.

ASH_AI_CACHE

Optional Provider-native Cache Toggle. Par défaut aktivéiert wann et ënnerstëtzt gëtt; acceptéiert1,true,yes,on,enabled,0,false,no,off, oderdisabled(case-sensibel).

ASH_AI_ENDPOINT

Néideg Basis URL fir den Chat API Endpunkt.

ASH_AI_MODEL

Néideg Modell Numm un den Endpunkt geschéckt.

ASH_AI_PROVIDER

Optional Provider iwwerschreiden. Wann net ausgesat ass,ashdetektéiert de Provider vum Endpunkt.

ASH_AI_TIMEOUT

Optional Ufro Timeout. Standard:3m.

ASH_ALWAYS_OPENAI_API

Optional Testen Toggle. Wann richteg-wëll, routes derollamaProvider duerch den OpenAI-kompatiblen SDK-Adapter anstatt seng handgerullt Implementatioun. Akzeptéiert déi selwecht boolesch Wäerter wéiASH_AI_CACHE. Standard: op.

ASH_ATTACHMENT_MAX_BYTES

Fakultativ maximal Gréisst an Bytes fir eng Datei iwwerginn--attach. Standard:10485760(10 MiB).

ASH_HISTORY_MAX

Fakultativ maximal Geschicht Messagen pro Schlëssel. Standard:40.

ASH_LOG_FILE

Optional Debug Log Wee wann verbose Logbuch aktivéiert ass.

ASH_LOG_MAX_BYTES

Optional maximal Loggréisst virun Rotatioun. Standard:1048576.

ASH_MAX_AGENTS

Optional maximal Ënner-Agenten generéiert vun engem Elterendeel Prozess. Standard:6.

ASH_MAX_TOOL_ITERS

Optional maximal AI Tool-Call Loop Iteratiounen. Standard:16.

ASH_RELEVANCE_WINDOW

Fakultativ rezent Outil Observatioune abegraff an Ausféierung Staat. Standard:4.

ASH_RETRY_BASE_DELAY

Optional Retry Backoff Base Verzögerung. Standard:250ms.

ASH_RETRY_MAX_ATTEMPTS

Fakultativ reprobable Ufro Versich. Standard:3.

ASH_SCHEDULED_TASK

Interne Scheduler Fändel benotzt vunash-verwalte invocations.

ASH_STREAM

Optional wiesselen. Wann richteg-ähnlech, streamt d'Äntwert vu Fournisseuren deenen hiren Adapter et ënnerstëtzt (aktuell nëmmen OpenAI). Akzeptéiert déi selwecht boolesch Wäerter wéiASH_AI_CACHE. Standard: op.

ASH_TASK_MAX

Optional Cap op Ausféierungsaufgaben ofgeleet vun enger Ufro. Standard:6.

ASH_TASK_STALL_ROUNDS

Optional Assistent Stall Ronnen virum Stoppen. Standard:2.

ASH_ALLOW

Fakultativ komma-getrennt ausführbar allowlist firrun_unix_command. Soss$XDG_CONFIG_HOME/ash/.ash_allow(Standard~/.config/ash/.ash_allow) benotzt gëtt; dëser Iwwerschreiden erweidert net internAshStongen.

ASH_DENY

Optional komma-getrennt Denylist fir explizit Kommandoen, Tools a Plugins ze blockéieren. Soss$XDG_CONFIG_HOME/ash/.ash_deny(Standard~/.config/ash/.ash_deny) benotzt gëtt.

ASH_TOOL_OUTPUT_MAX

Optional maximal erfaasst Tooloutput a Bytes. Standard:8192.

ASH_TOOL_TIMEOUT

Fakultativ lokal Outil Kommando Timeout. Standard:15s.

ASH_VERBOSE

Optional Debug Logging an Ausféierung Dashboard. Wäerter wéi1,true,on,an andebugaktivéieren et.

ASH_SESSION_ID

AshSessiounsidentifizéierer fir persistent Geschicht a Logbenennung. Generéiert wann net; ongëlteg explizit Wäerter ginn refuséiert. GenereschSESSION_IDgëtt ignoréiert.

Explizit numeresch an Dauer Astellunge ginn validéiert. Ganzer Grenzen muss positiv ausserASH_MAX_TOOL_ITERS, déi vläicht null sinn. AI / Tool Timeouts musse positiv sinn; Retry Verspéidungen kënnen null sinn awer net negativ. Dauer benotzen Go Syntax wéi30s,5m, oder1h. Mëssformt oder ausserhalb Wäerter produzéieren e Konfiguratiounsfehler anstatt roueg Standarden ze benotzen.

Dateien

• $XDG_CONFIG_HOME/ash/(Standard~/.config/ash/)—kanonesch Prompt, Politik a persistent Aarbechtsberäichdateien.
• $XDG_DATA_HOME/ash/(Standard~/.local/share/ash/)—gebündelt Tools, Plugins, Sproochepäck, a MCP Umeldungsinformatiounen.
• $XDG_STATE_HOME/ash/(Standard~/.local/state/ash/)—Geschicht, Schrummen, Logbicher, a Schlaang Staat.
• $XDG_CACHE_HOME/ash/(Standard~/.cache/ash/)—regeneréierbar Cache Dateien.

Exit Status

ash gëtt 0 op Erfolleg zréck. Et gëtt net-null zréck wann d'Konfiguratioun, d'Netzwierksufroen oder d'Ausféierung vum Tool feelen.

Beispiller

echo "summarize this directory" | ash
ash install --shell bash
ash install --shell zsh --dry-run

Kuckt och

bash(1),zsh(1),man(1)