ar27111994/agent-harness

Was macht agent-harness?

Node.js TypeScript-CLI zum Erkennen, Bereitstellen, Aktivieren und Verknüpfen von wiederverwendbaren KI-Agenten-Assets über VS Code/Copilot, OpenCode, Cursor, Zed, Claude Code und Pi.

Übersicht

Agent-Harness ist ein CLI-Werkzeug, das den Workflow zur Verwaltung von Agenten-Assets wie .cursorrules, .claude.md, .windsurfrules und agents.md optimiert. Es dient als zentrale Anlaufstelle, um sicherzustellen, dass Ihre KI-Agenten unabhängig von der gewählten Plattform auf die richtigen Anweisungen und Werkzeuge zugreifen.

Funktionen

• Erkennung (Discovery): Scannt Arbeitsbereiche nach vorhandenen Agentenkonfigurationsdateien und -ordnern.

• Bereitstellung (Staging): Erstellt temporäre Bereitstellungsbereiche, um Assets vor der endgültigen Aktivierung zu organisieren.

• Aktivierung (Activation): Wendet Assets auf den aktuellen Arbeitsbereich für eine bestimmte Plattform an.

• Verknüpfung (Wiring): Generiert plattformspezifische Verknüpfungen (z.B. Symlinks oder Konfigurationseinträge), um Agenten anzuweisen, die Assets zu laden.

• Plattformunterstützung:

  Plattform	Asset-Typ	Aktivierungsmethode
  VS Code/Copilot	.github/copilot-instructions.md	Kopieren in Repository
  OpenCode	opencode.json	Konfiguration aktualisieren
  Cursor	.cursorrules	Datei in Projektwurzel kopieren
  Zed	.zed/settings.json	Einstellungen aktualisieren
  Claude Code	CLAUDE.md	Datei in Projektwurzel kopieren
  Pi	agents.md	Datei in Projektwurzel kopieren

Verwendung

npx @ar27111994/agent-harness [Befehl] [Optionen]

Befehle

Befehl	Beschreibung
discover	Erkennt alle Agenten-Assets im aktuellen Verzeichnis.
stage <pfad>	Bereitstellen eines Assets für die Aktivierung.
activate [plattform]	Aktiviert bereitgestellte Assets auf der angegebenen Plattform.
wire [plattform]	Verknüpft aktivierte Assets mit dem Agenten.
help	Zeigt diese Hilfe an.

Optionen

Option	Beschreibung
--dry-run	Führt den Befehl aus, ohne Änderungen vorzunehmen.
--verbose	Ausführliche Ausgabe für Debugging-Zwecke.
--config <pfad>	Pfad zur Konfigurationsdatei (Standard: agent-harness.json).

Konfiguration

Erstellen Sie eine agent-harness.json-Datei im Stammverzeichnis Ihres Projekts:

{
  "plattformen": ["vscode", "opencode", "cursor", "zed", "claude", "pi"],
  "assets": [
    {
      "quelle": "./gemeinsam/regeln",
      "typ": "cursorrules"
    },
    {
      "quelle": "./anweisungen/agent.md",
      "typ": "claude"
    }
  ]
}

Beispiel

# Alle verfügbaren Assets erkennen
npx @ar27111994/agent-harness discover

# Ein Asset für Cursor bereitstellen
npx @ar27111994/agent-harness stage .cursorrules

# Bereitgestellte Assets für VS Code/Copilot aktivieren
npx @ar27111994/agent-harness activate vscode

# Aktivierte Assets mit dem Cursor-Agenten verknüpfen
npx @ar27111994/agent-harness wire cursor

Voraussetzungen

• Node.js 18 oder höher
• npm oder yarn

Installation

npm install -g @ar27111994/agent-harness

Oder mit npx ausführen (wie oben gezeigt).

Lizenz

MIT