Hoe ik Stopte met Betalen voor Cursor en Mijn Eigen AI-Agent in de Console Bouwde

Toen populaire AI-editors de prijzen weer verhoogden en limieten voor Claude afknepen, werd ontwikkelaar Mark Pfaffenberger boos. En schreef zijn eigen tool. Zo ontstond Code Puppy — een console AI-agent die gesloten IDE's zoals Cursor en Windsurf vervangt.

Het project heeft momenteel ongeveer 740 sterren op GitHub, maar de functies zijn interessant. Het is een flexibele terminalclient met API-sleutelrotatie, sessiepersistentie bij fouten en diepe aanpassingsmogelijkheden.

Waarom je een console-agent nodig hebt

Als je in de console werkt en geen zware Electron-editor open wilt houden, kan het slepen van monsterlijke plugins lastig zijn. Code Puppy start vanuit elke map met één commando en begrijpt onmiddellijk de projectstructuur.

Je kiest zelf het neurale netwerk, configureert systeemprompts en bepaalt waar je je gegevens naartoe stuurt.

Belangrijkste functies

Laten we praktische functies bekijken die het de moeite waard maken om de repository te bekijken.

Limieten omzeilen via modelrotatie

Rate limits per minuut zijn het meest vervelend wanneer je aan een complexe taak werkt. Code Puppy lost dit op met een ingebouwd Round Robin-algoritme. Je geeft meerdere API-sleutels op en de tool wisselt ertussen.

De configuratie staat in het configuratiebestand:

{
  "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
  }
}

Je hebt vijf verzoeken aan één sleutel gedaan, de tool gaat zonder pauze naar de volgende.

Toegang tot tientallen providers

Dankzij de integratie met models.dev hoef je niet handmatig eindpunten op te geven voor zeldzame neurale netwerken. Het /add_model commando opent een interactief TUI-menu direct in de console. Je kunt providers selecteren uit een enorme lijst: Groq, Cohere, Mistral, xAI en anderen.

Als de internetverbinding wordt verbroken, schakelt de client over naar de ingebouwde offline modeldatabase.

Fouttolerantie met DBOS

Tijdens lange codesessies gaat er soms iets mis: netwerkstoringen of het terminalvenster sluit per ongeluk. De DBOS-plugin slaat checkpoints op bij elke stap. Functieaanroepen, modelreacties en context worden vastgelegd in een lokale database.

Na herstart kun je de sessie precies hervatten waar alles crashte.

Aangepaste agents in JSON-formaat

Je kunt profielen maken voor specifieke taken. Bouw bijvoorbeeld een codereview-agent die alleen toegang heeft tot bestandslezen en grep-zoekopdrachten.

Het configuratiebestand gaat in de agents-directory:

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

Agents wisselen gaat rechtstreeks tijdens het werk via het /agent code-reviewer commando.

Nul datacollectie

De auteur heeft bewust geweigerd voor analytics en telemetrie. Geen prompts, bestandspaden of call logs verlaten de project servers.

Bij gebruik van Ollama of vLLM verlaten gegevens je computer helemaal niet.

Hoe het te proberen

Je hebt Python 3.11 of nieuwer nodig om het uit te voeren. De snelste manier om de tool te starten is via uv:

uvx code-puppy

Na het opstarten moet je sleutels invoeren voor de LLM's die je gebruikt of een lokaal eindpunt opgeven.

Voor wie is dit

De tool bleek gedurfd en onderscheidend. Standaard is de agent nogal temperamentvol en weigert bestanden te wijzigen die groter zijn dan 600 regels code, waardoor je op tijd moet refactoren.

Het project zal aanspreken bij degenen die van CLI-tools houden, niet maandelijks willen betalen en liever zelf de API-tokenspending bepalen.