04 — Befehle & Tools erkunden

📜

~150 Befehle

Vollständiger Commands-Katalog

🔧

~100 Tools

Vollständiger Tools-Katalog

🔍

Suche & Filter

Präzise Ergebnisse finden

🛡️

Permissions

Sicherheit kontrollieren

📜

Übersicht

Commands-Übersicht

Alle verfügbaren Befehle auflisten und durchsuchen.

Kern Anfänger

Der Claw Code Harness verfügt über einen umfangreichen Katalog von ~150 Befehlen, die aus archivierten JSON-Snapshots geladen werden. Diese Befehle decken alle Aspekte der KI-Agent-Interaktion ab — von Git-Operationen bis hin zu komplexen Workflows.

Alle Befehle anzeigen

Der grundlegende Befehl zeigt den gesamten Commands-Katalog:

bash

$ python3 -m src.main commands

Verfügbare Commands (~150):

• git-commit — Commits Änderungen
• git-branch — Branch-Verwaltung
• git-push — Push zu Remote
• git-pull — Pull von Remote
• git-status — Status anzeigen
• git-log — Commit-History
• git-diff — Änderungen vergleichen
• git-merge — Branches mergen
• git-rebase — Commits rebasen
• git-checkout — Branch wechseln
... (weitere Befehle)

Ausgabe begrenzen mit --limit

Bei vielen Befehlen empfiehlt es sich, die Ausgabe zu begrenzen:

# Nur die ersten 10 Befehle anzeigen
$ python3 -m src.main commands --limit 10

# Nur die ersten 20 Befehle anzeigen
$ python3 -m src.main commands --limit 20

# Kombiniert mit Suche
$ python3 -m src.main commands --query "git" --limit 5

💡

Pro-Tipp

Verwende --limit immer in Kombination mit --query, um fokussierte Ergebnismengen zu erhalten. Das erleichtert die Übersichtlichkeit im Terminal.

🔧

Übersicht

Tools-Übersicht

Alle verfügbaren Tools auflisten und durchsuchen.

Kern Anfänger

Neben den Befehlen stellt der Harness ~100 Tools zur Verfügung. Tools sind Funktionen, die der Agent zur Interaktion mit dem System nutzt — Dateien lesen, Befehle ausführen, Code analysieren und vieles mehr.

Alle Tools anzeigen

bash

$ python3 -m src.main tools

Verfügbare Tools (~100):

• Read — Datei lesen
• Write — Datei schreiben
• Edit — Datei bearbeiten
• Bash — Shell-Befehl ausführen
• Glob — Dateien suchen (Pattern)
• Grep — In Dateien suchen
• View — Verzeichnis anzeigen
• LS — Dateien auflisten
• Run — Python-Code ausführen
• Search — Volltextsuche
... (weitere Tools)

Kompakte Ansicht mit --simple-mode

Für eine schnelle Übersicht ohne Details:

$ python3 -m src.main tools --simple-mode

Tools (kompakt):
Read, Write, Edit, Bash, Glob, Grep, View, LS, Run, Search, ...

MCP-Tools ausblenden mit --no-mcp

MCP (Model Context Protocol) Tools können ausgeblendet werden:

# Nur Basis-Tools anzeigen, keine MCP-Erweiterungen
$ python3 -m src.main tools --no-mcp

# Kombiniert mit Limit
$ python3 -m src.main tools --no-mcp --limit 15

⚠️

Tool-Kategorien

Tools sind in Kategorien wie file (Datei-Operationen), search (Suche), exec (Ausführung) und mcp (Erweiterungen) organisiert. Verwende die Suchfunktion, um nach Kategorien zu filtern.

🔍

Suche & Filter

Filtern und Suchen

Präzise Suche mit --query und verschiedene Filter-Optionen.

Kern Fortgeschritten

Die Suchfunktion durchsucht Namen, Beschreibungen und Source-Hints. Sie ist case-insensitive und unterstützt Teilwort-Übereinstimmungen.

Die --query Option

bash

# Nach Git-Befehlen suchen
$ python3 -m src.main commands --query "git"

Gefundene Commands (8):
• git-commit
• git-branch
• git-push
• git-pull
• git-status
• git-log
• git-diff
• git-merge

# Nach Datei-Tools suchen
$ python3 -m src.main tools --query "file"

# Nach "read" suchen (Case-insensitive)
$ python3 -m src.main tools --query "READ"

Plugin-Befehle ausblenden (--no-plugin-commands)

Standardmäßig werden auch Plugin-Befehle angezeigt. Um nur Core-Befehle zu sehen:

# Nur Core-Befehle, keine Plugins
$ python3 -m src.main commands --no-plugin-commands

# Kombiniert mit Suche
$ python3 -m src.main commands --query "commit" --no-plugin-commands

Kombinierte Filter-Beispiele

--query string

Suchbegriff für Filterung nach Name, Beschreibung oder Source-Hint

python3 -m src.main commands --query "branch" --limit 5

--limit integer

Begrenzt die Anzahl der angezeigten Ergebnisse

python3 -m src.main tools --limit 10

--no-plugin-commands flag

Blendet alle Plugin-Befehle aus, zeigt nur Core-Befehle

python3 -m src.main commands --no-plugin-commands

--no-mcp flag

Blendet alle MCP (Model Context Protocol) Tools aus

python3 -m src.main tools --no-mcp

--simple-mode flag

Zeigt nur Namen und Kurzbeschreibungen in kompakter Form

python3 -m src.main tools --simple-mode --limit 20

Komplexe Suchanfragen

# Suche nach "push" in Core-Befehlen, max. 3 Ergebnisse
$ python3 -m src.main commands --query "push" --no-plugin-commands --limit 3

# Suche nach "read" in Basis-Tools (ohne MCP)
$ python3 -m src.main tools --query "read" --no-mcp --limit 5

# Alle Datei-bezogenen Core-Befehle kompakt anzeigen
$ python3 -m src.main commands --query "file" --no-plugin-commands --simple-mode

📋

Details

Einzelne Einträge anzeigen

Detaillierte Informationen zu spezifischen Befehlen und Tools abrufen.

Kern

Für detaillierte Analysen kannst du einzelne Befehle oder Tools anzeigen lassen. Dies zeigt alle verfügbaren Metadaten, einschließlich Parameter, Beschreibungen und Quellen.

Befehl-Details mit show-command

bash

$ python3 -m src.main show-command "commit"

Command Details: commit
========================
Name: commit
Responsibility: Creates a commit with the given message
Source Hint: src/commands/git.ts
Aliases: git-commit, ci
Args: ["message", "files"]
Category: version-control

# Weitere Beispiele
$ python3 -m src.main show-command "git-branch"
$ python3 -m src.main show-command "push"

Tool-Details mit show-tool

$ python3 -m src.main show-tool "Read"

Tool Details: Read
==================
Name: Read
Description: Reads the contents of a file
Permission Level: read-only
Parameters: ["path", "offset", "limit"]
Returns: File contents as string

# Weitere Beispiele
$ python3 -m src.main show-tool "Bash"
$ python3 -m src.main show-tool "Write"
$ python3 -m src.main show-tool "Glob"

Wichtige Felder in der Detail-Ansicht

Feld	Bedeutung (Commands)	Bedeutung (Tools)
`name`	Eindeutiger Befehlsname	Eindeutiger Tool-Name
`responsibility`	Beschreibung der Funktion	—
`description`	—	Beschreibung der Funktion
`source_hint`	Quelldatei im Original	—
`permission_level`	—	read-only / read-write / dangerous
`args`	Erwartete Parameter	—
`parameters`	—	Erwartete Parameter
`category`	Kategorie-Gruppierung	Kategorie-Gruppierung

💡

Namenskonvention

Bei show-command und show-tool ist die Groß-/Kleinschreibung wichtig. Verwende die exakte Schreibweise wie im Listing angezeigt. Bei Unsicherheit nutze die Liste mit --query zur Suche.

🛡️

Sicherheit

Permission-Optionen

Tools blockieren und Berechtigungen für sichere Ausführung kontrollieren.

Fortgeschritten Kern

Das Permission-System ermöglicht es, bestimmte Tools zu blockieren oder ganze Kategorien auszuschließen. Dies ist besonders wichtig für sichere Umgebungen oder wenn bestimmte Operationen verhindert werden sollen.

Einzelnes Tool blockieren (--deny-tool)

bash

# Bash-Tool blockieren
$ python3 -m src.main tools --deny-tool Bash

# Write-Tool blockieren
$ python3 -m src.main tools --deny-tool Write

# Mehrere Tools blockieren
$ python3 -m src.main tools --deny-tool Bash --deny-tool Write --deny-tool Edit

Nach Präfix blockieren (--deny-prefix)

Alle Tools mit einem bestimmten Präfix blockieren:

# Alle MCP-Tools blockieren (Präfix "mcp__")
$ python3 -m src.main tools --deny-prefix mcp__

# Alle "file_"-Tools blockieren
$ python3 -m src.main tools --deny-prefix file_

Permission-Levels verstehen

Level	Bedeutung	Beispiele
read-only	Nur lesende Operationen	Read, Glob, Grep, View
read-write	Lesen und Schreiben	Write, Edit
dangerous	Potentiell destruktiv	Bash, Run (mit Dateisystem-Zugriff)

Sicherheits-Best-Practices

Nur Lesen erlauben

Für rein informative Analysen blockiere alle write- und dangerous-Tools:
--deny-tool Write --deny-tool Edit --deny-tool Bash

MCP-Tools isolieren

Externe MCP-Erweiterungen können mit --no-mcp oder --deny-prefix mcp__ deaktiviert werden.

Kombinierte Filterung

Verwende mehrere Permission-Optionen kombiniert für feinere Kontrolle über die Tool-Auswahl.

# Beispiel: Maximale Sicherheit
# - Keine Plugin-Befehle
# - Keine MCP-Tools
# - Keine gefährlichen Tools
$ python3 -m src.main tools \
--no-mcp \
--deny-tool Bash \
--deny-tool Write \
--deny-tool Edit \
--limit 10

✅

Zusammenfassung

Du kennst jetzt alle Optionen zum Erkunden von Befehlen und Tools:
• --limit für begrenzte Ergebnismengen
• --query für gezielte Suche
• --no-plugin-commands und --no-mcp für Filterung
• --deny-tool und --deny-prefix für Permission-Control
• show-command und show-tool für Details