---

Inhaltsverzeichnis

• Warum AISH
• Schnellstart
• Installation
• Deinstallation
• Konfiguration
• Verwendung
• Sicherheit & Risikokontrolle
• Skills (Plugins)
• Daten & Datenschutz
• Dokumentation
• Community & Support
• Entwicklung & Tests
• Mitwirken
• Lizenz

---

Warum AISH

• Echte interaktive Shell: Vollständige PTY-Unterstützung, läuft mit interaktiven Programmen wie vim / ssh / top
• KI-native Integration: Aufgaben in natürlicher Sprache beschreiben, Befehle generieren, erklären und ausführen
• Sicher & kontrollierbar: KI-Befehle mit Risikostufen und Bestätigungsfluss; optionaler Sandbox-Probelauf zur Änderungsbewertung
• Erweiterbar: Skills-Plugin-System mit Hot-Loading und Prioritätsüberschreibung
• Geringe Migrationskosten: Kompatibel mit üblichen Befehlen und Workflows, standardmäßig alles im Terminal

---

Funktionsvergleich

Funktion	AISH	Claude Code
🎯 Kernausrichtung	Ops/System‑Troubleshooting‑CLI	Entwicklungs‑Coding‑Assistent
🤖 Multi‑Modell‑Support	✅ Vollständig offen	⚠️ Hauptsächlich Claude
🔧 Sub‑Agenten‑System	✅ ReAct‑Diagnoseagent	✅ Mehrere Agententypen
🧩 Skills‑Support	✅ Hot‑Loading	✅
🖥️ Native Terminalintegration	✅ Vollständige PTY‑Unterstützung	⚠️ Eingeschränkte Unterstützung
🛡️ Sicherheits‑Risikobewertung	✅ Sicherheitsbestätigung	✅ Sicherheitsbestätigung
🌐 Unterstützung lokaler Modelle	✅ Vollständig unterstützt	✅ Vollständig unterstützt
📁 Werkzeuge für Dateiverarbeitung	✅ Minimale Kernunterstützung	✅ Vollständige Unterstützung
💰 Komplett kostenlos	✅ Open Source	❌ Kostenpflichtiger Dienst
📊 Beobachtbarkeit	✅ Langfuse optional	⚠️ Integriert
🌍 Mehrsprachige Ausgabe	✅ Automatische Erkennung	✅

---

Schnellstart

1) Installieren und Starten

Option 1: Einzeilige Installation (empfohlen)

curl -fsSL https://www.aishell.ai/repo/install.sh | bash

Option 2: Manuelle Bundle-Installation

Lade das passende aish-<version>-linux-<arch>.tar.gz-Bundle aus dem offiziellen Release-Verzeichnis herunter und führe dann aus:

tar -xzf aish-<version>-linux-<arch>.tar.gz
cd aish-<version>-linux-<arch>
sudo ./install.sh

Dann starten:

aish

Hinweis: aish ohne Unterbefehle entspricht aish run.

2) Wie eine normale Shell verwenden

aish> ls -la
aish> cd /etc
aish> vim hosts

3) Lass die KI die Arbeit erledigen (mit ;) starten)

Beginnend mit ; oder ； gelangst du in den KI‑Modus:

aish> ;finde Dateien größer als 100M im aktuellen Verzeichnis und sortiere nach Größe
aish> ;erkläre diesen Befehl: tar -czf a.tgz ./dir

---

Installation

Linux-Release-Bundle

curl -fsSL https://www.aishell.ai/repo/install.sh | bash

Der Installer ermittelt die neueste stabile Version, lädt das passende Bundle für deine Architektur herunter und installiert aish, aish-sandbox und aish-uninstall in /usr/local/bin.

Aus dem Quellcode ausführen (Entwicklung/Test)

cargo run --bin aish

---

Deinstallation

Deinstallieren (Konfigurationsdateien behalten):

sudo aish-uninstall

Vollständige Deinstallation (entfernt auch systemweite Sicherheitsrichtlinien):

sudo aish-uninstall --purge-config

Optional: Benutzerkonfiguration bereinigen (löscht Modell/API-Keys usw.):

rm -rf ~/.config/aish

---

Konfiguration

Speicherort der Konfigurationsdatei

• Standard: ~/.config/aish/config.yaml (oder $XDG_CONFIG_HOME/aish/config.yaml, wenn XDG_CONFIG_HOME gesetzt ist)

Priorität (hoch nach niedrig)

1. Kommandozeilenargumente
2. Umgebungsvariablen
3. Konfigurationsdatei

Minimales Konfigurationsbeispiel

# ~/.config/aish/config.yaml
model: openai/deepseek-chat
api_base: https://openrouter.ai/api/v1
api_key: your_api_key

Alternativ über Umgebungsvariablen (besser für Secrets):

export AISH_MODEL="openai/deepseek-chat"
export AISH_API_BASE="https://openrouter.ai/api/v1"
export AISH_API_KEY="your_api_key"

Tipp: LiteLLM unterstützt ebenfalls das Lesen anbieterspezifischer Umgebungsvariablen (z. B. OPENAI_API_KEY, ANTHROPIC_API_KEY).

Interaktive Konfiguration (optional):

aish setup

Tool-Calling-Kompatibilitätsprüfung (bestätigt, dass das gewählte Modell/der Kanal Tool Calling unterstützt):

aish check-tool-support --model openai/deepseek-chat --api-base https://openrouter.ai/api/v1 --api-key your_api_key

Langfuse (optionale Observability):

1. In der Konfiguration aktivieren:

enable_langfuse: true

1. Umgebungsvariablen setzen:

export LANGFUSE_PUBLIC_KEY="..."
export LANGFUSE_SECRET_KEY="..."
export LANGFUSE_HOST="https://cloud.langfuse.com"

aish check-langfuse führt Prüfungen aus, wenn check_langfuse.py im Projektstamm vorhanden ist.

---

Verwendung

Häufige Eingabetypen

Typ	Beispiel	Beschreibung
Shell‑Befehle	ls -la, cd /path, git status	Normale Befehle direkt ausführen
KI‑Anfragen	;wie prüfe ich Port‑Belegung, ;finde Dateien größer als 100M	Mit ;/；‑Präfix in den KI‑Modus
Integrierte Befehle	help, clear, exit, quit	Integrierte Shell‑Steuerbefehle
Modellwechsel	/model gpt-4	Modell anzeigen oder wechseln

Shell‑Kompatibilität (PTY)

aish> ssh user@host
aish> top
aish> vim /etc/hosts

---

Sicherheit & Risikokontrolle

AI Shell führt Sicherheitsbewertungen nur für KI-generierte und zur Ausführung vorbereitete Befehle durch.

Risikostufen

• LOW: Standardmäßig erlaubt
• MEDIUM: Bestätigung vor Ausführung
• HIGH: Standardmäßig blockiert

Pfad der Sicherheitsrichtliniendatei

Richtliniendateien werden in folgender Reihenfolge aufgelöst:

1. ~/.config/aish/security_policy.yaml (benutzerspezifisch; automatisch generierte Vorlage, falls nicht vorhanden)

Sandbox-Probelauf (optional, empfohlen für Produktion)

Die Standardrichtlinie hat den Sandbox-Probelauf deaktiviert. Zum Aktivieren:

1. In der Sicherheitsrichtlinie setzen:

global:
  enable_sandbox: true

1. Privilegierten Sandbox-Service starten (systemd):

sudo systemctl enable --now aish-sandbox.socket

Standard-Socket: /run/aish/sandbox.sock. Wenn die Sandbox nicht verfügbar ist, greift je nach Richtlinie sandbox_off_action (BLOCK/CONFIRM/ALLOW).

---

Skills (Plugins)

Skills erweitern das Domänenwissen und die Workflows der KI und unterstützen Hot‑Loading sowie Prioritätsüberschreibung.

Standard-Scan-Verzeichnisse und Priorität:

• ~/.config/aish/skills/ (oder $AISH_CONFIG_DIR/skills)
• ~/.claude/skills/

---

Daten & Datenschutz

Dieses Projekt speichert folgende Daten lokal (für Troubleshooting und Nachvollziehbarkeit):

• Logs: Standard ~/.config/aish/logs/aish.log
• Sitzungen/Verlauf: Standard ~/.local/share/aish/sessions.db (SQLite)
• Große Ausgaben‑Offload: Standard ~/.local/share/aish/offload/

Empfehlungen:

• Keine echten API-Keys ins Repository committen; bevorzugt Umgebungsvariablen oder Secret-Management.
• In Produktionsumgebungen können Sicherheitsrichtlinien die für die KI zugänglichen Verzeichnisse einschränken.

---

Dokumentation

• Konfigurationsleitfaden: CONFIGURATION.md
• Schnellstart: QUICKSTART.md
• Mechanismus zur Befehlskorrektur: docs/command-interaction-correction.md

---

Community & Support

Link	Beschreibung
Official Website	Projektstartseite und weitere Informationen
GitHub Repository	Quellcode und Issue‑Tracking
GitHub Issues	Bug‑Reports
GitHub Discussions	Community‑Diskussionen
Discord	Community beitreten

---

Entwicklung & Tests

cargo test --workspace
./packaging/tests/release_scripts_smoke.sh

---

Mitwirken

Siehe CONTRIBUTING.md für Richtlinien.

Lizenz

LICENSE (Apache 2.0)