Wie ich aufgehört habe, für Cursor zu zahlen, und meinen eigenen KI-Agenten in der Konsole gebaut habe

Als beliebte KI-Editoren erneut die Preise erhöhten und Limits für Claude kürzten, wurde Entwickler Mark Pfaffenberger wütend. Und schrieb sein eigenes Tool. So entstand Code Puppy – ein Konsolen-KI-Agent, der geschlossene IDEs wie Cursor und Windsurf ersetzt.

Das Projekt hat derzeit etwa 740 Sterne auf GitHub, aber die Features sind interessant. Es ist ein flexibler Terminal-Client mit API-Key-Rotation, Sitzungspersistenz bei Fehlern und tiefer Anpassung.

Warum Sie einen Konsolen-Agenten brauchen

Wenn Sie in der Konsole arbeiten und keinen schweren Electron-Editor offen halten wollen, können sperrige Plugins mühselig sein. Code Puppy startet mit einem einzigen Befehl aus jedem Ordner und versteht sofort die Projektstruktur.

Sie wählen selbst das neuronale Netz, konfigurieren System-Prompts und entscheiden, wohin Ihre Daten gehen.

Hauptfunktionen

Schauen wir uns die praktischen Features an, die es wert machen, das Repository zu checken.

Limits durch Modell-Rotation umgehen

Rate Limits pro Minute sind am nervigsten, wenn Sie an einer komplexen Aufgabe arbeiten. Code Puppy löst das mit einem eingebauten Round-Robin-Algorithmus. Sie geben mehrere API-Keys an, und das Tool wechselt zwischen ihnen.

Die Konfiguration liegt in der Config-Datei:

{
  "qwen1": {
    "type": "cerebras",
    "name": "qwen-3-coder-480b",
    "custom_endpoint": {
      "url": "https://api.cerebras.ai/v1",
      "api_key": "$CEREBRAS_API_KEY1"
    }
  },
  "qwen2": {
    "type": "cerebras",
    "name": "qwen-3-coder-480b",
    "custom_endpoint": {
      "url": "https://api.cerebras.ai/v1",
      "api_key": "$CEREBRAS_API_KEY2"
    }
  },
  "cerebras_round_robin": {
    "type": "round_robin",
    "models": ["qwen1", "qwen2"],
    "rotate_every": 5
  }
}

Nach fünf Anfragen an einen Key wechselt das Tool ohne Pause zum nächsten.

Zugriff auf Dutzende von Providern

Dank der Integration mit models.dev müssen Sie Endpoints für seltene neuronale Netze nicht manuell angeben. Der Befehl /add_model öffnet ein interaktives TUI-Menü direkt in der Konsole. Sie können Provider aus einer großen Liste auswählen: Groq, Cohere, Mistral, xAI und andere.

Wenn die Internetverbindung unterbrochen wird, schaltet der Client auf die eingebaute Offline-Modell-Datenbank um.

Fehlertoleranz mit DBOS

Bei langen Code-Generierungs-Sessions geht manchmal etwas schief: Netzwerkunterbrechungen oder das Terminalfenster wird versehentlich geschlossen. Das DBOS-Plugin speichert Checkpoints bei jedem Schritt. Funktionsaufrufe, Modell-Antworten und Kontext werden in einer lokalen Datenbank aufgezeichnet.

Nach einem Neustart können Sie die Session genau dort fortsetzen, wo alles abgestürzt ist.

Eigene Agenten im JSON-Format

Sie können Profile für bestimmte Aufgaben erstellen. Zum Beispiel einen Code-Review-Agenten bauen, der nur Zugriff auf Dateilesen und grep-Suche hat.

Die Konfigurationsdatei kommt ins agents-Verzeichnis:

{
  "name": "code-reviewer",
  "display_name": "Code Reviewer",
  "description": "Проверяет код на ошибки и безопасность",
  "system_prompt": [
    "Ты опытный инженер, проводящий ревью кода.",
    "Обращай внимание на безопасность и поддерживаемость.",
    "Предлагай конкретные исправления."
  ],
  "tools": ["list_files", "read_file", "grep", "agent_share_your_reasoning"]
}

Der Agentenwechsel passiert direkt während der Arbeit über den Befehl /agent code-reviewer.

Null Datensammlung

Der Autor hat bewusst auf Analytics und Telemetrie verzichtet. Keine Prompts, Dateipfade oder Anrufprotokolle verlassen die Projekt-Server.

Bei Verwendung von Ollama oder vLLM verlassen Daten Ihr Gerät überhaupt nicht.

Wie Sie es ausprobieren

Sie brauchen Python 3.11 oder neuer, um es auszuführen. Der schnellste Weg, das Tool zu starten, ist über uv:

uvx code-puppy

Nach dem Start müssen Sie Keys für die LLMs eingeben, die Sie nutzen, oder einen lokalen Endpoint angeben.

Für wen ist das gedacht

Das Tool ist mutig und eigenwillig geworden. Standardmäßig ist der Agent ziemlich launisch und lehnt es ab, Dateien zu ändern, die größer als 600 Zeilen Code sind, und zwingt Sie dazu, rechtzeitig zu refaktorisieren.

Das Projekt wird denen gefallen, die CLI-Tools lieben, nicht für monatliche Abonnements zahlen wollen und ihre API-Token-Ausgaben lieber selbst kontrollieren.