valantic
Intelligence & Engineering
Setup Guide · Developer Tools

pi coding agent
Customization & MAS

Dieser Guide dokumentiert die korrekte Einrichtung und Erweiterung des pi Terminal-Agenten. Basierend auf der offiziellen Dokumentation zeigen wir die Projekt-Customization über das .pi Verzeichnis sowie den Aufbau eines Multi-Agent Systems (MAS) über die pi-teams Extension.

# Globale Installation von Node.js vorausgesetzt (v18+) npm install -g @mariozechner/pi-coding-agent # Authentifizierung (API-Key setzen oder OAuth via /login) pi
Schritt 1

Offizielle Customization

Pi lässt sich tiefgreifend auf Projektbasis anpassen. Alle lokalen Modifikationen werden im .pi Ordner im Root-Verzeichnis des Projekts abgelegt. Pi erkennt diese Struktur automatisch beim Starten der Session.

  • Strikte Trennung von globaler und lokaler Konfiguration.
  • System-Prompts ersetzen oder ergänzen.
  • Skills (Tools & Prompts) modular on-demand laden.
  • Programmierbare TypeScript-Extensions.
Ladeverhalten

Pi liest beim Start sowohl das globale Verzeichnis ~/.pi/ als auch das lokale .pi/ Verzeichnis des aktuellen Workspaces aus. Lokale Konfigurationen überschreiben dabei die globalen Settings.

Schritt 2

Multi-Agent Systems (MAS)

Mit der offiziell unterstützten Extension pi-teams wird der einzelne Agent zu einem koordinierten Engineering-Team erweitert.

Die Extension nutzt Terminal-Multiplexer (tmux, Zellij, WezTerm, iTerm2), um autonome Teammate-Agenten in separaten Panes zu starten. Diese arbeiten parallel, kommunizieren miteinander und verwalten ein Shared Task Board.

  • Natives Multi-Agent Setup direkt im Terminal.
  • Automatische Model-Resolution (z.B. gpt-4o, haiku).
  • Smart Cleanup von verwaisten Agent-Sessions nach 1h.
# 1. pi-teams als Extension installieren pi install npm:pi-teams # 2. Team Umgebung starten (z.B. in tmux) tmux new-session -s my-project

Interaktion mit pi-teams

# Innerhalb der Pi-Session (im Terminal-Multiplexer): User: "Erstelle ein Team namens 'backend-team' mit dem Modell 'gpt-4o'" # pi-teams orchestriert nun den Team Lead und das Board. User: "Spawn 'security-bot' um die Dependencies nach Lücken zu scannen" # Ein neuer Pane öffnet sich, der spezialisierte Agent übernimmt den Task. User: "Spawn 'frontend-dev' mit Modell 'haiku' für schnelle React Iterationen" # Ein weiterer Agent wird im Split-Pane mit spezifischem Modell gestartet.
Referenz

Wichtige Befehle

Sitzungsverwaltung

  • pi Interaktive TUI
  • pi -c Letzte Session fortführen
  • pi -r Vergangene Session auswählen
  • pi --no-session Ohne Historie starten

Shortcuts (In-Session)

  • Ctrl+L Provider/Model wechseln
  • /skill <name> Skill aktivieren
  • /<template> Prompt-Template laden
  • @datei Kontext referenzieren

Teams (pi-teams)

  • Benötigt: tmux, zellij, o.ä.
  • Start per Prompt: "Create a team..."
  • Cleanup: Automatisch nach 1 Stunde (~/.pi/agent/teams/)