Heefeg gestallte
Froen.

Ugefaangen

Wat brauch ech ier ech benotzen kannash?

Dir braucht deashausführbar, en AI Endpunkt an e Modellnumm. Lafenash installautomatesch konfiguréiert dës: et benotzt e scho gesate Cloud Provider API Schlëssel oder e lafende lokalen Inferenzserver wann se fonnt ginn, soss weist et e nummeréiert Providermenü a freet no engem API Schlëssel, da léisst Dir e Modell aus der Modelllëscht vum Endpunkt wielen. Dir kënnt och setzenASH_AI_ENDPOINTanASH_AI_MODELmanuell. E lokalen Endpunkt wéi Ollama ka benotzenhttp://localhost:11434, an e LAN Host wéihttp://brain.local:11434oder eng privat IP gëtt och als lokal behandelt (ausserASH_STRICT=1); Cloud Endpunkte mussen HTTPS benotzen an normalerweis erfuerderenASH_AI_AUTH_TOKEN. Shell Integratioun ass opt-in: Dir kënnt ëmmer lafenash "your question"direkt.

Wou méchtashinstalléieren, a wéi kontrolléieren ech datt meng Schuel et fanne kann?

D'verifizéiert Installateur Plazeashan~/.local/bin/ash. Füügt dee Verzeichnis op ÄrPATHbenotzt Är Shell d'normale Konfiguratioun;ash installännert keng Shell Startupdateien ausser Dir passéiert--shell-integration. Öffnen en neien Terminal, da lafencommand -v ashze bestätegen. De Self-Updater installéiert seng Ersatzbinär op déiselwecht Benotzer-lokal Plaz. Den Installateur erfuerdert Sigstorecosignder ënnerschriwwen Checksum Manifest z'iwwerpréiwen.

Wéi benotzen echashouni meng Schuel ze änneren?

Gitt eng zitéiert Ufro direkt:ash "how do I find large files?". Ouni Argumenter,ashakzeptéiert och en net-interaktiven Standard-Input-Prompt, wéi zgit diff | ash. Direkt Notzung ass déi mannst iwwerraschend Optioun wann Dir léiertashoder schreift e Skript.

Firwat méchtashsoen meng AI Configuratioun ass onkomplett?

Check datASH_AI_ENDPOINTanASH_AI_MODELsinn net eidel an der Ëmwelt wouashleeft. Fir e Cloud Hostnumm, och gesatASH_AI_AUTH_TOKENwann néideg vum Provider. Lafenprintf '%s\n' "$ASH_AI_ENDPOINT" "$ASH_AI_MODEL"fir ze bestätegen datt déi éischt zwee Wäerter präsent sinn, awer dréckt net en Authentifikatiounstoken an eng Terminalopnam oder e gemeinsame Logbuch.

Installatioun an Aktualiséierung

Maachtashschaffen op Windows 11?

Net gebierteg.ashënnerstëtzt bash, zsh, a Fish op macOS, Linux, a FreeBSD; et gëtt keen PowerShell Installatiounsziel. Benotzt WSL fir déi ënnerstëtzt Linux Erfahrung.

Wéi installéieren echasham Windows Subsystem fir Linux (WSL)?

Follegt deLinux Installatiounsinstruktiounenbannent Ärer WSL Verdeelung, léiwer säi Package Manager. Danne Provider konfiguréieren an optional Bash Integratioun aktivéieren. Et gëtt keen native Windows Installateur.

Wéi update echashop déi lescht Verëffentlechungsversioun?

Benotzt de Besëtzer Package Manager fir Homebrew / APT / DNF / Pacman Installatiounen.ash updateass nëmme fir stabil Release Installatiounen ënner~/.local/bin; et verifizéiert de Sigstore-ënnerschriwwene Manifest an den Archivverdauung, a refuséiert eng gescheitert Ënnerschrëft. Native .pkg a Custom-directory installs brauchen hiren ursprénglechen Installateur / manuelle Ersatz. KucktAktualiséierungen a Kanalabonnementerfir Release, Beta, an Nightly.

Ech sinn gelafash install. Firwat ännert sech näischt an dësem Terminal?

Shell Integratioun ass par défaut deaktivéiert. Fir et z'aktivéieren, lafenash install --shell bash --shell-integration(oder wieltzshoderfish); et iwwerschreift net de Shellprozess dee scho leeft. Öffnen en neien Terminal oder lued déi gewielte Startupdatei nei. Lafenash install --shell bash --disable-shell-integrationewechzehuelenAsh's verwaltete Block wärend Ëmgéigend Inhalt erhaalen.

Onbekannt Kommandoen soen ëmmer nach "net fonnt." Wéi léisen ech Shell Integratioun?

Fir d'éischt ze bestätegen datt Dir Shellintegratioun aktivéiert huttash install --shell bash --shell-integration(ersetzen Är Schuel), da lafencommand -v ash; den Hook kann net eng Binär opruffen, déi Är Shell net fënnt. Reload oder restart d'Shell a kontrolléiert datt seng Startupdatei den>>> ash install >>>geréiert Block. Endlech lafenash snooze off, well e Snooze bewosst onbekannt Kommandoen als normal "net fonnt" Feeler léisst.

Wat Dateien méchtash installänneren, a kann ech et Virschau?

Et geréiert Configuratioun ënner$XDG_CONFIG_HOME/ash(Standard~/.config/ash), Daten ënner$XDG_DATA_HOME/ash(Standard~/.local/share/ash), Staat ënner$XDG_STATE_HOME/ash(Standard~/.local/state/ash), an de Cache ënner$XDG_CACHE_HOME/ash(Standard~/.cache/ash). Startupdateien ginn nëmme geännert mat--shell-integration. Benotztash install --shell bash --shell-integration --dry-runVirschau; dry-run schreift keng Dateien. Installatioun nei lafen ass idempotent; benotzen--overwritenëmmen wann Dir verwaltete Bootstrap Dateien erfrëscht wëllt.

MaachtashËnnerstëtzung Fësch?

Jo. Lafenash install --shell fish --shell-integrationoptéieren.ashfüügt e verwaltete Block un$XDG_CONFIG_HOME/fish/config.fish, oder~/.config/fish/config.fishwann XDG_CONFIG_HOME unset ass. Fësch benotztfish_command_not_found, also en ongeléiste Kommando erreechtashmat hiren originelle Argumenter.

Firwat net kleng Buschtawentestantypeam Fësch?

Fësch reservéiert déi kleng Buschtawen Nimm als wesentlech Buildins an erlaabt net eng Funktioun fir se ze ersetzen. BenotztTest ...oderType ...auszedréckenashAbsicht oder Opruffash "..."direkt. Aner kompatibel Kollisiounsverpackungen bleiwen verfügbar.

Wat iwwer ksh93?

ksh93 gëtt net fir Shell Integratioun ënnerstëtzt. SengFPATHVerhalen kann nëmmen eng Datei no engem onbekannte Kommando lueden; et huet keng generesch Kommando-net-fonnt Callback datt sécher ëmsetzen kannashprompt Routing oder Broker Liewenszyklus.

AI a Verbindungen

Maachtashenthält den AI?

Nee.ashass e Client fir en AI Endpunkt deen Dir konfiguréiert. SetztASH_AI_ENDPOINTanASH_AI_MODEL;ashënnerstëtzt lokal Ollama an aner lokal OpenAI-kompatibel Serveren (LM Studio, llama.cpp, MLX, LocalAI, vLLM, Text-generation-webui, Jan, GPT4All), an entdeckt ënnerstëtzt Cloud-Provider Adapter vum Endpunkt, mat engem fakultativenASH_AI_PROVIDERiwwerschreiden.

Wat sinn MCP Serveren, a wéi addéieren ech een?

MCP (Model Context Protocol) Serveren weisen Tools aus, déi en AI Modell kann nennen, sou wéi Sich, Analyse oder Servicespezifesch Aktiounen. Remote Serveren sinn net als Standard aktivéiert. Fir e vertrauenswürdege Streamable HTTP MCP Server ze addéieren, benotztash mcp add <url>oder füügt seng URL op seng eege Linn an$XDG_CONFIG_HOME/ash/.ash_allow(Standard~/.config/ash/.ash_allow).Ashverbënnt duerch säi Broker a bitt de Server Tools un de Modell. Benotzt nëmmen Serveren déi Dir vertraut: hir Tools kënnen Handlungen aus Ärem Numm maachen. HTTPS ass erfuerderlech ausser fir localhost Entwécklungsserver. Wann d'MCP Initialiséierung feelt,ashgeet weider ouni Remote MCP Tools: et warnt an interaktiven Sessiounen a bleift roueg an net-interaktiven Sessiounen.

Kann geplangten Aarbechtsplaze MCP Server benotzen?

Nee Geplangte an aner net-interaktiv Aarbechtsplazen ierwen keen interaktiven Shell Broker, sou datt Remote MCP Tools net verfügbar sinn.Ashleeft nach ëmmer d'Prompt ouni MCP Tools an ënnerdréckt dësen erwaarten Initialiséierungsfehler. Eng Ufro, déi op MCP hänkt, kann also fäerdeg sinn ouni déi ugefrote Donnéeën oder Handlungen. Zäitplang keng Ufroen déi MCP erfuerderen.

Wierker MCP wannASH_STRICT=1?

Jo. Eng HTTP(S) URL Linn registréiert explizit en MCP Server a gëtt net als Shell ausführbar behandelt. Strikt Modus deaktivéiert net konfiguréiert MCP Server. Et gëllt nach ëmmerAsh's net zouverlässeg Ausgangsschutz fir zréckginn Toolinhalt.

Wéi funktionnéiert MCP OAuth, a wou ginn Umeldungsinformatiounen gespäichert?

Fir en OAuth-geschützte Server,Ashmécht d'Autorisatiounssäit am Desktop Browser op wann e GUI verfügbar ass; wann et e Browser net kann opmaachen, dréckt et eng URL fir manuell an engem Browser op deemselwechte Host ze autoriséieren. Benotztash mcp add <url> --no-browserfir ëmmer den Terminalflow ze benotzen. 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. De Broker handhabt den Callback, Tokenaustausch, Erfrëschung a persistent MCP Sessioun. Umeldungsinformatiounen ginn am Betribssystem Umeldungsmanager gespäichert wann verfügbar. Wann et net verfügbar ass, konfiguréiert de verschlësselte Dateifallback mat engem zoufälleg 32-ByteASH_MCP_CREDENTIAL_KEY;Ashspäichert ni de Schlëssel selwer.

Wou kann ech den AUTH_KEY fir déi populärste Cloud AI Ubidder fannen?

ashbenotztASH_AI_AUTH_TOKENfir seng fakultativ Träger Token; et erstellt oder verdeelt net Provider Schlësselen. Schafen e Schlëssel an Ärem Provider Kont, wéiOpenAI,Anthropesch,Google AI Studio,Azure OpenAI,Mistral,Zesummenhang,Groq,xAI,DeepSeek,Zesummen AI,Open Router,HuggingFace, oderOllama, exportéiert se dann als Ëmfeldvariabel vum Provider (oder SetASH_AI_AUTH_TOKENdirekt).ash installauto-detektéiert ënnerstëtzt Provider-spezifesch Ëmwelt Verännerlechen. Cloud Endpunkte mussen HTTPS benotzen an en Token erfuerderen ausser AWS Bedrock; privat / LAN Adressen an.localHostnumm ginn als lokal behandelt ausserASH_STRICT=1gesat ass.

Maachtashall Kéier eng nei Verbindung opmaachen?

Net fir normal interaktiv Unix Shell Benotzung. Bash, zsh, a Fish starten ee Broker pro Shell Sessioun, kommunizéieren mat him duerch e privaten Unix Socket, a weiderbenotzen säi begrenzten HTTP Verbindungspool. De Broker geet no Inaktivitéit eraus; geplangte Aarbechtsplaze benotzen direkt Ufroen anstatt e persistent Shellbroker.

Benotzt Fësch de Broker?

Jo. De Fish Wrapper fänkt un a benotzt de selwechte Per-Session Broker wéi Bash an Zsh, erfrëscht säi Leasing direkt virun engemashufroen, an hält Broker Setup roueg.

Wat geschitt wann eng Ufro lues, net verfügbar ass oder ech meng Gedanken änneren?

PressCtrl-Cfir eng Ufro am Fluch ze annuléieren. De Standard AI Ufro Timeout ass dräi Minutten; setzenASH_AI_TIMEOUT, zum BeispillASH_AI_TIMEOUT=90s, fir et z'änneren.ashwidderholl AI-Feeler bis zu dräimol als Standard mat engem kuerze begrenzten Réckzuch; tune dat Verhalen matASH_RETRY_MAX_ATTEMPTS,ASH_RETRY_BASE_DELAY,an anASH_RETRY_MAX_DELAY.

Sécherheet a Kontroll

Wéi spären echashfir méi sécher ze sinn, a wat sinn d'Implikatiounen?

Halt déi ausführbar Erlaabneslëscht schmuel, favoriséiert nëmme liest Tools, a füügt keng privilegiéiert oder zerstéierend Kommandoen derbäi. SetztASH_STRICT=1fir unerkannt Prompt-Injektiounsmuster vun onvertrauenswürdege Tool, Datei, Skript, Pipeline a Kand-Agent Output ze blockéieren. Dëst kann och legitimen Text verstoppen, deen op eng Injektiounsversuch gläicht. D'Erlaabneslëscht ass eng Ausféierungsgrenz, net eng Sandkëscht:ashan erlaabt Tools lafen nach ëmmer wéi Dir.

Kannashzerstéierende Kommandoen lafen wéirm?

Net mat der installéierter Standard Erlaabneslëscht. Et beréit explizit géintrm,mv,dd,chmod,chown,kill,an ansudo. Wann Dir ee vun hinnen bäidréit,ashkann et mat Äre Permissiounen ufroen; iwwerpréift dës Entscheedung suergfälteg.

Wéi änneren ech d'Befehleashass erlaabt auszeféieren?

Edit$XDG_CONFIG_HOME/ash/.ash_allow(Standard~/.config/ash/.ash_allow) a lëschten ausführbaren Nimm, een pro Zeil oder komma-getrennt. Seng eegestänneg$TOOLS_DIR_LISTan$PLUGINS_DIR_LISTDirektiven erlaben berechtegt verwaltete Scripten an gebierteg Plugins; ersetzen se mat wuertwiertlech Nimm fir eng restriktiv Politik. Berechtegt Scripten a Plugins si regelméisseg ausführbar Dateien ënner$XDG_DATA_HOME/ash/toolsan$XDG_DATA_HOME/ash/plugins(Standard Basis~/.local/share/ash). Füügt verweigert Kommandoen un$XDG_CONFIG_HOME/ash/.ash_deny, oder setzenASH_ALLOW/ASH_DENYzu komma-getrennte Lëschten. Ännerungen ginn op der nächster geliesashufroen.

Wat Benotzer assashënner lafen?

ashan all erlaabt Tool lafen als de Benotzer deen ufänktash. Et erhéicht keng Privilegien.Ash-verwalte XDG Verzeechnes a Dateien benotzen restriktiv Permissiounen, awer hiren Inhalt bleift zougänglech fir Äre Benotzer an all Prozess deen Dir explizit erlaabt.

MaachtashVertrauen Text kritt via Päif d'selwecht wéi Benotzer Text? Wéi eng Protectiounen existéiere fir béiswëlleg Donnéeën?

Jo. Wéiniashkritt keng Kommandozeilargumenter a Standardinput gëtt gepäift, et behandelt dësen Input als Benotzerprompt. Päif net ontrauen Websäiten, Logbicher oder generéierten Text direkt unashausser Dir wëllt et als Ufro autoriséieren. Dëst ënnerscheet sech vunash-Manager Tool, Datei, Skript, Pipeline, a Kand-Agent Output:ashEtikéiert dës Resultater als net zouverlässeg Beweiser an instruéiert de Modell ni Instruktioune vun hinnen ze verfollegen. SetztASH_STRICT=1fir zousätzlech unerkannt Prompt-Injektiounssätz an ontrauen Beweiser ze ersetzen. D'Erlaabneslëscht an d'direkt-argv Ausféierungsregele gëllen nach ëmmer fir d'Ausféierung vum Tool.

Sinn mengashDateien privat vun anere Benotzer op dësem Computer?

Ash-verwalte XDG Verzeichnisser a Dateien benotzen restriktiv Besëtzer-nëmmen Permissiounen wou ënnerstëtzt. Dëst schützt géint aner lokal Konten ënner normalen Unix Permissiounen, awer net géint Ären eegene Kont, Administrateuren, Backups oder Software déi Dir gewielt hutt mat Zougang zu Ärem Heemverzeichnis ze lafen.

Tools a Workflow

MaachtashËnnerstëtzung Päifen an aner Unix Traditiounen?

Jo. Dir kënnt Text anashals Ufro, zum Beispillgit diff | ash. For AI-requested tool pipelines,ashënnerstëtzt zwee bis siechzéng zulässlech ausführbaren, déi direkt ouni Shell verbonne sinn, wéi zls | grep pattern | pbcopy. Shell-Kontrollmuster an Tool Argumenter sinn blockéiert, an all ausführbar an engemash-verwalte Pipeline muss erlaabt sinn.

WëllashKommandoen a menge Shell-Skripten, SSH Kommandoen oder Cron Jobs nei interpretéieren?

Nee D'Bash an zsh Integratioun Wrappers zréck direkt an net-interaktiven Shells, sou Scripten, CI Aarbechtsplazen, SSH One-Liner, a Cron Kommandoen halen normal Kommando-net-fonnt Verhalen. Benotzt eng explizit Uruff wéiash "summarize this log"odersome-command | ashwann Automatisatioun soll ruffenash.

Wéi stoppen echashvun Interpretatioun vun meng Kommandoen fir e puer Minutten?

Lafenash snoozefir d'Standard fënnef Minutten, oder spezifizéiert eng Dauer wéiash snooze 30soderash snooze 1h. Lafenash snooze offfir direkt erëmzefannen. Snooze pauses automatesch Kommando-net-fonnt a wrapper Routing; explizitash ...Kommandoen funktionnéieren nach ëmmer.

Wéi kann ech Debuggenasha gesinn méi Informatiounen iwwert wat et mécht?

SetztASH_VERBOSE=1virum Lafenashfir strukturéiert Debug-Output an e Terminal Ausféierung Dashboard z'aktivéieren. SetztASH_LOG_FILEfir Debug JSON op eng Datei ze schreiwen;ASH_LOG_MAX_BYTESKontrollen Rotatioun an Default op 1 MiB wann e Log Fichier konfiguréiert ass.

Wéi eng Limite gëllen wannashleeft Tools?

Par défaut huet all Toolruff e 15 Sekonnen Timeout an erfaasst bis zu 8192 Bytes vum Output. Eng AI Ufro ka bis zu 16 Tool-Loop Iteratiounen maachen, an engash-managed Pipeline huet zwee bis siechzéng Etappen. Ajustéieren der Outil Timeout an Output Limite matASH_TOOL_TIMEOUTanASH_TOOL_OUTPUT_MAX; halen Ausgang fokusséiert mat Kommandoen wéihead,tail, odergrep.

Wou ass de Standardsystemprompt?

Déi kanonesch Promptdatei ass$XDG_CONFIG_HOME/ash/.ash_system(Standard~/.config/ash/.ash_system), aus dem gebündelten Standard installéiert wann Dir leeftash install. Bestehend Dateien ënner dem alen~/.ashAarbechtsberäich ginn net automatesch migréiert oder gelies. Gewéinlech$VARIABLEWäerter sinn aus der Ëmwelt erweidert, mä$TOOLS_DIR_LIST,$PLUGINS_DIR_LIST,an an$IF_PYTHON_AVAILABLEsinn intern reservéiertAshAuswiesselungen an ni Ëmwelt-ofgeleet.

Wou setzen ech meng eegen Scripten an native Plugins firashals Tool ze ruffen?

Setzt de Benotzer Python Scripten an$XDG_DATA_HOME/ash/tools/an gebierteg binär Plugins an$XDG_DATA_HOME/ash/plugins/(Standard Basis~/.local/share/ash). Vergewëssert Iech datt se ausführbar sinn, a füügt de blot ausführbaren Numm un$XDG_CONFIG_HOME/ash/.ash_allow(oder vertrauen op$TOOLS_DIR_LIST/$PLUGINS_DIR_LIST).Ashrifft keng Shell op fir erlaabt Unix Kommandoen a Plugins.

Wat sinn bescht Praktiken fir en Tool oder Plugin sou datt d'AI säin Zweck a seng Notzung versteet?

Follegt degebierteg Plugin Kontrakt: prévisibel CLI Optiounen ausstellen, implementéieren--help,--version, a Versioun JSON--ai-docsMetadaten, a beschreiwen Input / Output Schemaen a Feelerverhalen. Emittéiert kompakt strukturéiert JSON mat engemstatusFeld an actionable Feeler Detailer amplaz Prosa mat Daten gemëscht. Halt d'Output begrenzt, validéiert d'Inputen, setzt d'Netzwierk Timeouts, a maacht d'Tool sécher fir ëmmer erëm ze ruffen. Füügt säin bloe Dateinumm un$XDG_CONFIG_HOME/ash/.ash_allow;ashkann et nëmmen ausféieren wann et erlaabt ass an net opgelëscht ass$XDG_CONFIG_HOME/ash/.ash_deny.

Wat sinn déi geliwwert Tool Scripten an native Plugins?

Déi installéiert Bootstrap Python Scripte sinnheadlines.py,wikipedia.py,an anyfinance.pyan$XDG_DATA_HOME/ash/tools/. Déi geliwwert gebierteg Plugins sinnwhat_time_is_it(Gitt),flip_a_coin(Rust), ancalculator(TypeScript) an$XDG_DATA_HOME/ash/plugins/.

Rust-Plugins, dorënner flip_a_coin, ginn nëmmen op Linux a FreeBSD matgeliwwert. macOS-Builds enthalen what_time_is_it a calculator, awer keng Rust-Plugins.

Firwat feelt de Rust-Plugin op macOS, a wéi installéieren ech en manuell?

macOS léisst Rust-Plugins wéi flip_a_coin ewech, fir béid Architekturen op Linux ouni macOS-Runner ze bauen an d'CI-Käschten ze reduzéieren. Dat ass keng Kompatibilitéitsbegrenzung. Homebrew behält Go- an TypeScript-Plugins; Linux a FreeBSD behalen Rust.

Installéiert op Ärem Mac d'Xcode-Kommandozeilentools (xcode-select --install, wann néideg) a Rust iwwer rustup. Féiert dës Kommandoen do aus, wou eng nei Kopie vum Repository entstoe soll. De Makefile vum Plugin baut fir déi nativ Architektur an installéiert direkt am Benotzerverzeechnes, ouni sudo.

git clone https://github.com/Jonconradt/ash.git
cd ash
rustup toolchain install 1.99.0 --profile minimal
plugin_dir="${XDG_DATA_HOME:-$HOME/.local/share}/ash/plugins"
make -C internal/app/ash_bootstrap/plugins_src/flip_a_coin build BUILD_DIR="$plugin_dir"
"$plugin_dir/flip_a_coin" --version
"$plugin_dir/flip_a_coin" --ai-docs

Benotzt de Makefile vum Plugin, net make plugins-build, dat Rust op macOS iwwerspréngt. Behaalt $PLUGINS_DIR_LIST an ${XDG_CONFIG_HOME:-$HOME/.config}/ash/.ash_allow oder füügt flip_a_coin derbäi; den Numm däerf net an .ash_deny stoen. Start ash nei. Mat "$plugin_dir/flip_a_coin" test Dir ouni KI-Ubidder.

Kannashruffen Ënner-Agenten?

Jo. En Elterendeel Agent kann benotzenrun_sub_agentfir eng konzentréiert, onofhängeg Aufgab. E Kand ierft den Aarbechtsverzeechnes, d'Konfiguratioun, d'Tools an d'OS Permissiounen, gëtt e begrenzt Resultat zréck a kann net en anert Kand erstellen. De Standard Maximum ass sechs Ënner-Agenten pro Elterendeel lafen a ka geännert ginn matASH_MAX_AGENTS.

KannashGeneréiere Erënnerungsdateien fir komplex Aufgaben ze verfolgen a wat et an der Sessioun geléiert huet?

Jo. Et kann persistent Aarbechtsberäich Dateien ënner schreiwen$XDG_CONFIG_HOME/ash(Standard~/.config/ash), déi a sengem Aarbechtsberäich Inventar verfollegt ginn, a Sessiouns-scoped Scratch Dateien ënner$XDG_STATE_HOME/ash/scratch/<session-id>/(Standard Basis~/.local/state/ash). Scratch ass fakultativ: benotzt et fir wiederverwendbare Scripten, Zwëschendaten, akkumuléiert Erkenntnisser oder reviséierbar Artefakte wann se Wäert addéieren. Seng Tools sinnread_scratch_file,write_scratch_file,append_scratch_file,replace_scratch_file,edit_scratch_file,an anlist_scratch_files. AktivAshan broker Prozesser schützen hir Sëtzung mat engem OS Spär. Opgespaart Verzeechnes ginn gebotztAshAustrëtt nëmmen nodeems se méi al wéi 48 Stonnen sinn an net an 24 Stonnen zougänglech sinn; Crash-Iwwerreschter Sperrdateien blockéieren net spéider Botzen. Benotzt persistent Aarbechtsberäichdateien fir Informatioun déi Dir wëllt behalen.

KannashZäitplang Aarbecht fir spéider?

Jo, duerch seng AI Tools. Op macOS benotzt een eemolege Fuerplang e pro BenotzerlaunchdLaunchAgent a verlaangtlaunchctl. Op Linux ginn widderhuelend Zäitplang duerch Äre Benotzer ënnerstëtztcrontab;ashgeréiert nëmmen seng eege markéiert Entréen. Déi eemoleglaunchdScheduler ass net op Linux verfügbar, also benotzt e Cron-Entrée oder en anere Linux Scheduler fir eng eemoleg Linux Aarbecht. Geplangte Runen kréien e limitéierten Ëmfeld a benotzen direkt HTTPS anstatt en interaktiven Shell Broker, also suergt dofir datt déi erfuerderlech AI Konfiguratioun fir déi geplangten Aarbecht verfügbar ass. Si kënnen net Remote MCP Tools benotzen;Ashleeft ouni si a warnt net an net-interaktiven Sessiounen. Zäitplang keng Ufroen déi MCP erfuerderen.

Sessiounen a Späicheren

Wou sinn d'Geschicht oder Logdateien firash?

Gespréichsgeschicht gëtt als JSON ënner gespäichert$XDG_STATE_HOME/ash/history/(Standard~/.local/state/ash/history/). Geplangte Geschicht an Debug Logbicher ginn ënner deemselwechte Staatsverzeechnes gespäichert. Dir kënnt en aneren Debug-Log Wee wielen matASH_LOG_FILE.

Wéi laang ginn d'Geschichtsdateien gespäichert?

ashläscht Geschicht JSON Dateien méi al wéi 14 Deeg wärend der normaler Applikatiounsreinigung, mat engem 300 ms Botzbudget sou datt d'Ausfahrt net verspéit ass. Déi rezent Message Fënster ass separat: et hält bis zu 40 Messagen pro Gespréich als Standard a kann geännert ginn matASH_HISTORY_MAX.

Wéi läschen ech e Gespréich oder ufänken frësch?

Geschicht gëtt duerch Sessioun ID an AI Endpunkt / Modell Schlëssel getrennt. Start eng nei Terminal Sessioun fir eng nei Sessioun ID, oder läscht déi entspriechend JSON Datei ënner$XDG_STATE_HOME/ash/history/(Standard~/.local/state/ash/history/) wann Dir bewosst déi lokal Gespréichsgeschicht ewechgehäit wëllt. D'Ewechhuele vun enger Geschichtsdatei widderhëlt net e Providerschlëssel oder läscht Provider-Säit Daten; verwalten déi getrennt mam Provider.

Wat assASH_SESSION_IDa wou gëtt et generéiert?

Et ass denAsh-Besëtz pro Sessioun Identifizéierer benotzt fir Geschicht ze trennen, Scratch Space, Broker Sockets, a geplangte Log Nimm. De verwalteten Shell-Ëmfeld schaaft een wann d'Schuel ufänkt a behält et wann se resourcen;Ashschaaft eng fir invocations ouni Réibau Wäert. Eng genereschSESSION_IDgëtt ignoréiert.

Kann ech meng eegenASH_SESSION_ID?

Jo.Ashvalidéiert explizit IDen a refuséiert ongëlteg Wäerter anstatt se roueg ze ersetzen. Gëlteg IDen si maximal 128 Zeechen a benotzen Buschtawen, Zifferen, Ënnersträicher, Bindestrecken, mat engem fakultativen Kand-Sessioun Punkt Suffix. Benotzt net ontrauen oder gedeelt Wäerter: Kollisiounen kombinéieren Sessiounsgeschicht a Runtime Staat.

Ënnerstëtzung a Gemeinschaft

Wéi schreiwen ech e Feeler?

Öffnen en Thema opgithub.com/Jonconradt/ash/issuesmat derashVersioun oder engagéieren, Äre Betribssystem a Shell, d'Konfiguratioun relevant fir de Problem mat Geheimnisser ewechgeholl, reproduzéierbar Schrëtt, an dat observéiert Resultat. Fir eng Sécherheetsschwieregkeet, maach keng ëffentlech Ausgab op; mellt et privat per E-Mail oder GitHub Sécherheetsberodung.

Gëtt et eng Diskussioun Verwaltungsrot an derashProjet?

Jo. BenotztGitHub Diskussiounenfir Froen an Iddien, anGitHub Problemerfir reproduzéierbar Bugs a verfollegt Aarbecht.