jsuvic/agent-profile

Was macht agent-profile?

Terraform-ähnliche Konfiguration für KI-Codierungsagenten. Kompiliere eine ai-profile.yaml in sichere Codex-, Claude- und Tabnine-Konfigurationen.

Überblick

jsuvic/agent-profile ist ein Tool, das den Prozess der Konfiguration mehrerer KI-Codierungsagenten vereinfacht. Anstatt separate, plattformspezifische Konfigurationen für jeden Assistenten zu verwalten, definierst du alles in einer deklarativen ai-profile.yaml-Datei. Das Tool übersetzt diese in das Format, das von Agenten wie Codex (GitHub Copilot), Claude Code oder Tabnine verstanden wird – und stellt dabei sicher, dass Sicherheit und Konsistenz gewahrt bleiben.

Installation

pip install agent-profile
# oder
npm install -g agent-profile
# oder mit Homebrew (macOS/Linux)
brew install jsuvic/tap/agent-profile

Verwendung

1. Profil erstellen: Erstelle eine ai-profile.yaml im Stammverzeichnis deines Projekts.
2. Regeln definieren: Lege Regeln, Aliase, Ausschlüsse und Einschränkungen in YAML fest.
3. Konfigurationen generieren: Führe agent-profile compile aus, um für jeden unterstützten Agenten Konfigurationen zu generieren.

Beispiel ai-profile.yaml:

profile:
  name: mein-projekt-profil
  version: "1.0"

agent:
  codex:
    enabled: true
    instructions:
      - "Bevorzuge Python 3.10+ für neue Skripte."
      - "Verwende type hints, wenn möglich."
  claude:
    enabled: true
    system_prompt: "Du bist ein hilfreicher Assistent für die Softwareentwicklung."
  tabnine:
    enabled: false

rules:
  - type: include
    pattern: "src/**/*.py"
  - type: exclude
    pattern: "tests/"

Optionen

Befehl	Beschreibung
compile	Liest ai-profile.yaml und generiert Konfigurationen
validate	Validiert die ai-profile.yaml auf Fehler
list	Listet alle verfügbaren Agenten-Targets auf

Unterstützte Plattformen

• Codex (GitHub Copilot) – Erzeugt .github/copilot-instructions.md oder benutzerdefinierte Copilot-Konfigurationen.
• Claude (Anthropic) – Erzeugt eine CLAUDE.md oder Konfiguration für Claude Code / Claude Desktop.
• Tabnine – Erzeugt .tabnine oder tabnine_config.json.

Lizenz

MIT – siehe LICENSE.