{"id":51626703,"url":"https://github.com/waitdeadai/forgegod","last_synced_at":"2026-07-13T02:02:16.336Z","repository":{"id":348846305,"uuid":"1199984664","full_name":"waitdeadai/forgegod","owner":"waitdeadai","description":"Autonomous coding agent with web research (Recon), adversarial plan debate, 5-tier cognitive memory, multi-model routing (Gemini + DeepSeek + Ollama), 24/7 loops, and $0 local mode. Apache 2.0.","archived":false,"fork":false,"pushed_at":"2026-04-18T14:17:36.000Z","size":7565,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-18T15:10:08.725Z","etag":null,"topics":["agentic-ai","ai-coding-agent","anthropic","autonomous-coding","cli","code-generation","deepseek","developer-tools","gemini","llm","local-first","memory-system","multi-model","ollama","openai","openrouter","pydantic-ai","python","self-improving","web-research"],"latest_commit_sha":null,"homepage":"https://forgegod.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/waitdeadai.png","metadata":{"files":{"readme":"README.es.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-02T23:11:50.000Z","updated_at":"2026-04-18T14:17:40.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/waitdeadai/forgegod","commit_stats":null,"previous_names":["waitdeadai/forgegod"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/waitdeadai/forgegod","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waitdeadai%2Fforgegod","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waitdeadai%2Fforgegod/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waitdeadai%2Fforgegod/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waitdeadai%2Fforgegod/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/waitdeadai","download_url":"https://codeload.github.com/waitdeadai/forgegod/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waitdeadai%2Fforgegod/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35407393,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-13T02:00:06.543Z","response_time":119,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-ai","ai-coding-agent","anthropic","autonomous-coding","cli","code-generation","deepseek","developer-tools","gemini","llm","local-first","memory-system","multi-model","ollama","openai","openrouter","pydantic-ai","python","self-improving","web-research"],"created_at":"2026-07-13T02:02:15.430Z","updated_at":"2026-07-13T02:02:16.329Z","avatar_url":"https://github.com/waitdeadai.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"README.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/lang-en-blue.svg\" alt=\"English\"\u003e\u003c/a\u003e\n  \u003ca href=\"README.es.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/lang-es-yellow.svg\" alt=\"Español\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/mascot.png\" alt=\"Mascota oficial de ForgeGod\" width=\"120\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003csub\u003eDiseño oficial de la mascota por \u003ca href=\"https://www.linkedin.com/in/matt-mesa/\"\u003eMatias Mesa\u003c/a\u003e.\u003c/sub\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eForgeGod\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eEl agente de código que trabaja 24/7, aprende de sus errores, y cuesta $0 cuando quieras.\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://pypi.org/project/forgegod/\"\u003e\u003cimg src=\"https://img.shields.io/pypi/v/forgegod?color=00e5ff\u0026style=flat-square\" alt=\"PyPI\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/waitdeadai/forgegod/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-Apache%202.0-00e5ff?style=flat-square\" alt=\"Licencia\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.python.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/python-3.11+-00e5ff?style=flat-square\" alt=\"Python 3.11+\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/waitdeadai/forgegod/actions\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/waitdeadai/forgegod/ci.yml?style=flat-square\u0026color=00e5ff\" alt=\"CI\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://forgegod.com\"\u003e\u003cimg src=\"https://img.shields.io/badge/site-forgegod.com-00e5ff?style=flat-square\" alt=\"Website\"\u003e\u003c/a\u003e\n  \u003ca href=\"docs/AUDIT_2026-04-07.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/auditoria-2026.04.07-00e5ff?style=flat-square\" alt=\"Auditoria\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ccode\u003e23 herramientas\u003c/code\u003e \u0026bull; \u003ccode\u003e9 familias de proveedores\u003c/code\u003e \u0026bull; \u003ccode\u003eMemoria de 5 niveles\u003c/code\u003e \u0026bull; \u003ccode\u003eAutónomo 24/7\u003c/code\u003e \u0026bull; \u003ccode\u003eModo local $0\u003c/code\u003e\n\u003c/p\u003e\n\n---\n\nForgeGod orquesta múltiples LLMs (OpenAI, Anthropic, Google Gemini, Ollama, OpenRouter, DeepSeek, Kimi via Moonshot, Z.AI GLM y MiniMax) en un único motor de código autónomo. Enruta tareas al modelo correcto, corre 24/7 desde un PRD, aprende de cada resultado, y mejora su propia estrategia. Ejecutalo localmente por $0 con Ollama, usá API keys cuando haga falta, o conectá autenticación nativa de OpenAI Codex y Z.AI Coding Plan dentro del CLI de ForgeGod.\n\n```bash\npip install forgegod\n```\n\n\u003e Nota de auditoria (re-verificada 2026-04-17): la baseline verificada ahora incluye `23` herramientas registradas, `9` familias de proveedores, `10` superficies de ruteo, `672` tests recolectados, `587` tests no-stress pasando mas `1` skipped por defecto, `84/84` stress tests pasando, lint en verde, compilacion bytecode en verde, build del paquete en verde, y smoke checks vivos para `forgegod`, `forgegod run`, `forgegod hive`, `forgegod audit`, `forgegod obsidian`, `forgegod bridge` y `forgegod integrations`. El camino de integracion strict con Docker sigue siendo opt-in y solo corre cuando el daemon local realmente esta listo. La investigacion antes de programar ahora esta conectada al runtime para tareas con cambios de codigo, un mal review dispara troubleshooting research-backed en lugar de cortar en seco, y el analisis acotado con subagentes ya es una superficie opt-in viva en `forgegod`, `forgegod run` y `forgegod hive` via `--subagents`. ForgeGod tambien expone `forgegod audit` como bridge nativo hacia `audit-agent`; `forgegod loop` y `forgegod hive` pueden refrescar artefactos de auditoria antes de planificar y frenan limpio cuando el repo no esta listo para planificar. La entrada principal para personas ahora es el modo conversacional `forgegod`; auto-crea config local en el primer uso y respeta los mismos overrides de runtime que las superficies para scripts, incluyendo `--terse`, overrides de modelo, flags de permisos/aprobacion, preferencia de proveedor y seleccion explicita de superficie OpenAI. `forgegod run` queda como superficie explicita para scripts, `forgegod hive` ya esta vivo como coordinador local multi-proceso con worktrees aislados, y `forgegod evals` cubre regresiones deterministicas de chat, run, loop, worktree, interfaz strict y superficies OpenAI. El soporte nativo de Codex en Windows ahora es un camino production-ready dentro de ForgeGod cuando el Codex CLI oficial esta instalado y con login hecho. `forgegod loop` ya no auto-commitea ni hace auto-push por defecto. Lee [docs/AUDIT_2026-04-07.md](docs/AUDIT_2026-04-07.md), [docs/OPERATIONS.md](docs/OPERATIONS.md), [docs/WEB_RESEARCH_2026-04-07.md](docs/WEB_RESEARCH_2026-04-07.md), [docs/OPENAI_SURFACES_2026-04-10.md](docs/OPENAI_SURFACES_2026-04-10.md), [docs/WEB_RESEARCH_2026-04-17_MULTI_AGENT_SURFACES.md](docs/WEB_RESEARCH_2026-04-17_MULTI_AGENT_SURFACES.md) y [docs/WEB_RESEARCH_2026-04-17_OPENCLAW_HERMES_INTEGRATIONS.md](docs/WEB_RESEARCH_2026-04-17_OPENCLAW_HERMES_INTEGRATIONS.md) antes de tocar comportamiento de runtime.\n\n### Harness Experimental Recomendado: GLM-5.1 + Codex\n\nPara la configuración por suscripción más fuerte hoy dentro de ForgeGod, usá\n`glm-5.1` para `planner` / `researcher` / `coder` y `openai-codex:gpt-5.4`\npara `reviewer` / `sentinel` / `escalation`.\n\nMirá [docs/GLM_CODEX_HARNESS_2026-04-08.md](docs/GLM_CODEX_HARNESS_2026-04-08.md),\n[docs/examples/glm_codex_coding_plan.toml](docs/examples/glm_codex_coding_plan.toml),\ny corré `python scripts/smoke_glm_codex_harness.py` antes de usarlo en tareas críticas.\nEl camino con `ZAI_CODING_API_KEY` funciona hoy en ForgeGod, pero sigue siendo\nexperimental hasta que Z.AI reconozca explícitamente a ForgeGod como coding\ntool soportada.\n\n### Modos de Superficie OpenAI\n\nSi querés mantener ForgeGod dentro de superficies OpenAI, aplicá una\nsuperficie explícita:\n\n- `planner = openai:gpt-5.4`\n- `coder = openai:gpt-5.4-mini`\n- `reviewer = openai-codex:gpt-5.4`\n- `sentinel = openai:gpt-5.4`\n- `escalation = openai:gpt-5.4`\n- `researcher = openai:gpt-5.4-mini`\n\n```bash\nforgegod auth explain --profile adversarial --prefer-provider openai --openai-surface api+codex\nforgegod auth sync --profile adversarial --prefer-provider openai --openai-surface api+codex\n```\n\nForgeGod ahora soporta cuatro modos explícitos de superficie OpenAI:\n\n- `auto`\n- `api-only`\n- `codex-only`\n- `api+codex`\n\n`api+codex` mantiene el split adversarial, pero vuelve explícito el contrato:\nla OpenAI API maneja roles de builder/investigación y la suscripción Codex\nmaneja el reviewer cuando ambas están conectadas. El billing de ChatGPT/Codex\ny el billing del API de OpenAI siguen siendo superficies separadas.\n\nSi querés una configuración más simple, ForgeGod también soporta `single-model`\ndurante `forgegod init` y `forgegod auth sync --profile single-model`. Eso\nfuerza todos los roles a un solo modelo detectado en lugar del split\nadversarial recomendado.\n\n`forgegod` ahora es la entrada principal conversacional para personas y\nauto-crea config local en el primer uso. Usá `forgegod init` si querés el\nwizard guiado, y `forgegod run \"...\"` cuando necesites una superficie no\ninteractiva y reproducible para scripts, CI o automatización. Esa misma\nentrada raíz también acepta overrides de sesión como `--terse`, `--model`,\n`--review/--no-review`, `--permission-mode`, `--approval-mode` y\n`--allow-tool`.\n\n## Inicio Rápido (Sin Saber Programar)\n\nNo necesitás ser desarrollador para usar ForgeGod. Si podés describir lo que querés en español, ForgeGod escribe el código.\n\n### Opción A: Modo Local Gratuito ($0)\n\n1. Instalá Ollama: https://ollama.com/download\n2. Descargá un modelo: `ollama pull qwen3.5:9b`\n3. Instalá ForgeGod: `pip install forgegod`\n4. Iniciá la sesión: `forgegod`\n5. Pedile algo en lenguaje natural, por ejemplo: `Creá un sitio web simple con un formulario de contacto`\n6. Si querés el wizard guiado, corré: `forgegod init --lang es`\n\n\n### Opción B: Modo Suscripción OpenAI Nativa\n\n1. Instalá ForgeGod: `pip install forgegod`\n2. Ejecutá: `forgegod auth login openai-codex`\n3. Inspeccioná el split OpenAI que querés: `forgegod auth explain --profile adversarial --prefer-provider openai --openai-surface api+codex`\n4. Ejecutá: `forgegod auth sync --profile adversarial --prefer-provider openai --openai-surface api+codex`\n5. Iniciá la sesión: `forgegod`\n6. Pedile algo en lenguaje natural, por ejemplo: `Construí una API REST con autenticación de usuarios`\n\n### Opción C: Modo Z.AI Coding Plan\n\n1. Exportá `ZAI_CODING_API_KEY=...`\n2. Instalá ForgeGod: `pip install forgegod`\n3. Ejecutá: `forgegod auth sync --profile adversarial`\n4. Iniciá la sesión: `forgegod`\n5. Pedile algo en lenguaje natural, por ejemplo: `Construí una API REST con autenticación de usuarios`\n\n### ¿Algo no funciona?\n\nEjecutá `forgegod doctor` — revisa tu instalación y te dice exactamente qué corregir.\n\n## Por Qué ForgeGod es Diferente\n\nTodos los demás CLIs de código usan **un modelo a la vez** y **se reinician a cero** cada sesión. ForgeGod no.\n\n| Capacidad | Claude Code | Codex CLI | Aider | Cursor | **ForgeGod** |\n|:----------|:----------:|:---------:|:-----:|:------:|:------------:|\n| Ruteo multi-modelo automático | - | - | manual | - | **sí** |\n| Híbrido local + nube | - | básico | básico | - | **nativo** |\n| Loops autónomos 24/7 | - | - | - | - | **sí** |\n| Memoria entre sesiones | básica | - | - | removida | **5 niveles** |\n| Estrategia auto-mejorable | - | - | - | - | **sí (SICA)** |\n| Modos de presupuesto | - | - | - | - | **sí** |\n| Generación Reflexión | - | - | - | - | **3 intentos** |\n| Worktrees git paralelos | subagentes | - | - | - | **si (loop + hive)** |\n| Probado bajo estrés + benchmarks | - | - | - | - | **[linea base auditada](docs/AUDIT_2026-04-07.md)** |\n\n### La Ventaja: Harness \u003e Modelo\n\nEl scaffolding agrega [~11 puntos en SWE-bench](https://arxiv.org/abs/2410.06992) — la ingeniería del harness importa tanto como el modelo. ForgeGod es el harness:\n\n- **Ralph Loop** — Código 24/7 desde un PRD. El progreso vive en git, no en el contexto del LLM. Agente fresco por historia. Sin degradación de contexto.\n- **Memoria de 5 Niveles** — Episódica (qué pasó) + Semántica (qué sé) + Procedimental (cómo lo hago) + Grafo (cómo se conectan las cosas) + Errores-Soluciones (qué arregla qué). Las memorias decaen, se consolidan y se refuerzan automáticamente.\n- **Coder Reflexión** — 3 intentos de generación de código con modelos escalonados: local (gratis) → nube (barato) → frontier (cuando importa). El repo ya conecta scoping de workspace, auditoría de comandos, rutas bloqueadas y advertencias de código generado en runtime, mientras la auditoría sigue marcando los gaps de hardening que quedan.\n- **DESIGN.md Nativo** — Importás un preset, dejás `DESIGN.md` en la raíz, y las tareas frontend heredan ese lenguaje visual automáticamente.\n- **Subagentes + Hive** — Usá análisis acotado de solo lectura con `--subagents` dentro de una tarea, o repartí stories independientes con el coordinador local `forgegod hive` usando worktrees git aislados.\n- **Modo Contribución** — Lee `CONTRIBUTING.md`, inspecciona el repo, detecta issues abordables, y planifica o ejecuta cambios chicos respetando reglas del proyecto.\n- **SICA** — Agente de Código Auto-Mejorable. Modifica sus propios prompts, ruteo de modelos y estrategia basado en resultados. 6 capas de seguridad previenen la desviación.\n- **Modos de Presupuesto** — `normal` → `throttle` → `local-only` → `halt`. Activados automáticamente por gasto. Corre para siempre en Ollama por $0.\n\n## Inicio Rápido\n\n```bash\n# Instalar\npip install forgegod\n\n# Camino más rápido: hablar con ForgeGod directo\nforgegod\n\n# Setup guiado opcional\nforgegod init --lang es\n\n# O forzar un estilo de harness explícitamente\nforgegod init --lang es --profile adversarial\nforgegod init --lang es --profile single-model\n\n# Ver superficies de auth nativas\nforgegod auth status\n\n# Vincular la suscripción de OpenAI Codex y sincronizar defaults\nforgegod auth login openai-codex\nforgegod auth explain --profile adversarial --prefer-provider openai --openai-surface api+codex\nforgegod auth sync --profile adversarial --prefer-provider openai --openai-surface api+codex\n\n# Hablar con ForgeGod en lenguaje natural\nforgegod\nforgegod --subagents\n\n# Superficie explícita para scripts\nforgegod run \"Agregá un endpoint /health a server.py con uptime e info de versión\"\nforgegod run --subagents \"Agregá un endpoint /health a server.py con uptime e info de versión\"\n\n# Evals deterministicas del harness\nforgegod evals\nforgegod evals --case chat_natural_language_roundtrip\nforgegod evals --matrix openai-surfaces\nforgegod evals --matrix openai-live\nforgegod evals --matrix openai-live-compare\n\n# Planificar un proyecto → genera PRD\nforgegod plan \"Construí una API REST para una app de tareas con auth, CRUD y tests\"\n\n# Loop autónomo 24/7 desde PRD\n# Valores por defecto del loop: sin auto-commit ni auto-push salvo que lo actives explícitamente\n# Los workers paralelos requieren un repo git con al menos un commit porque ForgeGod usa worktrees aislados\n# Ver o refrescar artefactos de auditoria a nivel repo\nforgegod audit status\nforgegod audit run\nforgegod audit security\nforgegod audit architecture\nforgegod audit plan-risk\n\nforgegod loop --prd .forgegod/prd.json\n\n# Coordinador hive local multi-proceso con worktrees aislados\nforgegod hive --prd .forgegod/prd.json --workers 2\nforgegod hive --prd .forgegod/prd.json --workers 2 --subagents\n\n# Modo cavernícola — 50-75% ahorro de tokens con prompts ultra-concisos\nforgegod --terse\n\n# Ver qué aprendió\nforgegod memory\n\n# Ver desglose de costos\nforgegod cost\n\n# Benchmark de modelos\nforgegod benchmark\n\n# Evals del harness\nforgegod evals\n\n# Instalar un preset DESIGN.md para trabajo frontend\nforgegod design pull claude\n\n# Planear una contribución sobre otro repo\nforgegod contribute https://github.com/owner/repo --goal \"Mejorar tests\"\n\n# Chequeo de salud\nforgegod doctor\n```\n\n## Cómo Funciona el Ralph Loop\n\n```\n┌─────────────────────────────────────────────────┐\n│                  RALPH LOOP                     │\n│                                                 │\n│  ┌──────┐   ┌───────┐   ┌─────────┐   ┌─────┐   │\n│  │ LEER │──▶│ CREAR │──▶│EJECUTAR │──▶│VALI-│   │\n│  │ PRD  │   │AGENTE │   │HISTORIA │   │ DAR │   │\n│  └──────┘   └───────┘   └─────────┘   └──┬──┘   │\n│      ▲                                     │     │\n│      │         ┌────────┐    ┌────────┐    │     │\n│      └─────────│ ROTAR  │◀───│ COMMIT │◀───┘     │\n│                │CONTEXTO│    │O RETRY │   ok     │\n│                └────────┘    └────────┘          │\n│                                                 │\n│  El progreso está en GIT, no en contexto LLM.  │\n│  Agente fresco por historia. Sin degradación.  │\n│  Creá .forgegod/KILLSWITCH para detener.       │\n└─────────────────────────────────────────────────┘\n```\n\n1. **Leer PRD** — Elegir la historia TODO de mayor prioridad\n2. **Crear agente** — Contexto fresco (el progreso está en git, no en memoria)\n3. **Ejecutar** — El agente usa 23 herramientas para implementar la historia\n4. **Validar** — Tests, lint, sintaxis, revisión frontier\n5. **Finalizar o retry** — Pasa: revisar diff + marcar hecho. Falla: reintentar hasta 3x con escalamiento de modelo\n6. **Rotar** — Siguiente historia. El contexto siempre es fresco.\n\n## Sistema de Memoria de 5 Niveles\n\nForgeGod tiene el sistema de memoria más avanzado de cualquier agente de código open-source:\n\n| Nivel | Qué | Cómo | Retención |\n|:------|:----|:-----|:----------|\n| **Episódica** | Qué pasó por tarea | Registros completos de resultado | 90 días |\n| **Semántica** | Principios extraídos | Confianza + decaimiento + refuerzo | Indefinido |\n| **Procedimental** | Patrones de código y recetas | Seguimiento de tasa de éxito | Indefinido |\n| **Grafo** | Relaciones + aristas causales | Auto-extraído de resultados | Indefinido |\n| **Errores-Soluciones** | Patrón de error → solución | Búsqueda fuzzy | Indefinido |\n\nLas memorias **decaen** sin refuerzo (vida media de 30 días), se **consolidan** automáticamente (fusionan similares, podan débiles), y se **inyectan** en cada prompt como un Memory Spine ranqueado por relevancia + recencia + importancia.\n\n## Modos de Presupuesto\n\n| Modo | Comportamiento | Disparador |\n|:-----|:---------------|:-----------|\n| `normal` | Usa todos los modelos configurados | Por defecto |\n| `throttle` | Preferir local, nube solo para revisión | 80% del límite diario |\n| `local-only` | Solo Ollama, **operación $0** | Manual o 95% del límite |\n| `halt` | Detener todas las llamadas LLM | 100% del límite diario |\n\n## Modo Cavernícola (`--terse`)\n\nPrompts ultra-concisos que reducen el uso de tokens 50-75% sin pérdida de precisión para tareas de código. Respaldado por investigación 2026:\n\n- [Mini-SWE-Agent](https://github.com/SWE-agent/mini-swe-agent) — 100 líneas, \u003e74% SWE-bench Verified\n- [Chain of Draft](https://arxiv.org/abs/2502.18600) — 7.6% tokens, misma precisión\n- [CCoT](https://arxiv.org/abs/2401.05618) — 48.7% más corto, impacto insignificante\n\n```bash\n# Agregá --terse a cualquier comando\nforgegod --terse\nforgegod run --terse \"Construí una API REST\"\nforgegod loop --terse --prd .forgegod/prd.json\n\n# O habilitalo globalmente en config\n# [terse]\n# enabled = true\n```\n\n## Leaderboard de Modelos\n\nEjecutá el tuyo: `forgegod benchmark`\n\n| Modelo | Compuesto | Correctitud | Calidad | Velocidad | Costo | Auto-Reparación |\n|:-------|:---------:|:-----------:|:-------:|:---------:|:-----:|:---------------:|\n| openai:gpt-4o-mini | 81.5 | 10/12 | 7.4 | 12s prom | $0.08 | 4/4 |\n| ollama:qwen3.5:9b | 72.3 | 8/12 | 6.8 | 45s prom | $0.00 | 3/4 |\n\n*Ejecutá `forgegod benchmark --update-readme` para actualizar con tus propios resultados.*\n\n## Configuración\n\nForgeGod usa config TOML con prioridad de 3 niveles: variables de entorno \u003e proyecto \u003e global.\n\n`forgegod` auto-crea `.forgegod/config.toml` en la primera sesión conversacional con defaults sensibles a la auth detectada cuando puede. `forgegod init` y `forgegod auth sync` también escriben esos defaults y guardan `harness.profile` como `adversarial` o `single-model`. El ejemplo de abajo muestra la forma del archivo, no la única combinación recomendada.\n\n```toml\n# .forgegod/config.toml\n\n[models]\nplanner = \"openai:gpt-5.4\"            # Planificación frontier\ncoder = \"ollama:qwen3-coder-next\"     # Código local gratis\nreviewer = \"openai:gpt-5.4\"           # Puerta de calidad\nsentinel = \"openai:gpt-5.4\"           # Muestreo frontier\nescalation = \"openai:gpt-5.4\"         # Fallback para problemas difíciles\nresearcher = \"openai:gpt-5.4-mini\"    # Recon / síntesis web\n\n[budget]\ndaily_limit_usd = 5.00\nmode = \"normal\"\n\n[ollama]\nhost = \"http://localhost:11434\"\nmodel = \"qwen3-coder-next\"\n```\n\n### Variables de Entorno\n\n```bash\nexport OPENAI_API_KEY=\"sk-...\"\nforgegod auth login openai-codex           # Auth nativa OpenAI con ChatGPT\nexport ANTHROPIC_API_KEY=\"sk-ant-...\"     # Opcional\nexport OPENROUTER_API_KEY=\"sk-or-...\"     # Opcional\nexport GOOGLE_API_KEY=\"AIza...\"           # Opcional (Gemini)\nexport DEEPSEEK_API_KEY=\"sk-...\"          # Opcional\nexport MOONSHOT_API_KEY=\"sk-...\"          # Opcional (Kimi / Moonshot)\nexport ZAI_CODING_API_KEY=\"...\"           # Opcional (Z.AI Coding Plan)\nexport ZAI_API_KEY=\"...\"                  # Opcional (Z.AI API general)\n```\n\nO usá el archivo `.forgegod/.env` — `forgegod init` lo crea automáticamente.\n\n## Modelos Soportados\n\n| Proveedor | Modelos | Costo | Setup |\n|:----------|:--------|:------|:------|\n| **Ollama** | qwen3-coder-next, devstral, cualquiera | **$0** | `ollama serve` |\n| OpenAI API | gpt-5.4, gpt-5.4-mini, gpt-5.4-nano, o3, o4-mini | $$ | `OPENAI_API_KEY` |\n| Suscripción OpenAI Codex | gpt-5.4 vía superficie Codex | Incluida en planes ChatGPT soportados | `forgegod auth login openai-codex` |\n| Anthropic | claude-sonnet-4-6, claude-opus-4-6 | $$$ | `ANTHROPIC_API_KEY` |\n| Google Gemini | gemini-2.5-pro, gemini-3-flash | $$ | `GOOGLE_API_KEY` |\n| DeepSeek | deepseek-chat, deepseek-reasoner | $ | `DEEPSEEK_API_KEY` |\n| Kimi (Moonshot directo) | kimi-k2.5, kimi-k2-thinking | $$ | `MOONSHOT_API_KEY` |\n| Z.AI / GLM | glm-5.1, glm-5, glm-4.7 | $$ | `ZAI_CODING_API_KEY` o `ZAI_API_KEY` |\n| OpenRouter | 200+ modelos | varía | `OPENROUTER_API_KEY` |\n\nEl soporte de Kimi usa la API OpenAI-compatible oficial de Moonshot y hoy es experimental dentro de ForgeGod. Correlalo con tus benchmarks antes de convertirlo en modelo por defecto.\nEl soporte por suscripción de OpenAI Codex ahora es una superficie production-ready dentro de ForgeGod sobre instalaciones soportadas de Windows nativo o WSL. `codex-only` es el camino soportado para suscripción sola, y `forgegod evals --matrix openai-live-compare` es la vía de release para compararlo contra `api+codex` cuando ambas superficies de auth están conectadas.\nOpenRouter sigue funcionando con keys/créditos. Alibaba/Qwen Coding Plan sigue en evaluación porque la documentación oficial actual lo acota a coding tools soportadas, no a loops autónomos genéricos.\n\nRegla practica del harness:\n\n- `forgegod benchmark` mide performance de codigo/modelos sobre tareas scaffold\n- `forgegod evals` mide a ForgeGod mismo: UX conversacional, aprobaciones,\n  denegaciones por permisos, disciplina del completion gate, comportamiento de\n  loop/worktree y manejo de la interfaz strict. Ahora tambien separa scores por\n  `ux`, `safety`, `workflow` y `verification`, y trae\n  `forgegod evals --matrix openai-surfaces` para cobertura OpenAI-first\n  determinística, más `forgegod evals --matrix openai-live` para probes reales\n  baratos cuando las superficies OpenAI están enlazadas. Los reportes ahora\n  también incluyen trace graders locales.\n\n## Seguridad\n\nDefensa en profundidad, no teatro de seguridad:\n\n- **Lista de comandos bloqueados** — 13 patrones peligrosos bloqueados (`rm -rf /`, `curl | sh`, `sudo`, fork bombs)\n- **Redacción de secretos** — 11 patrones eliminan claves API de la salida de herramientas antes del contexto LLM\n- **Detección de inyección de prompts** — Archivos de reglas escaneados por patrones de inyección antes de cargar\n- **Límites de presupuesto** — Controles de costo previenen gasto descontrolado de API\n- **Killswitch** — Creá `.forgegod/KILLSWITCH` para detener inmediatamente los loops autónomos\n- **Protección de archivos sensibles** — `.env`, archivos de credenciales reciben advertencias + redacción automática\n\n\u003e **Advertencia**: ForgeGod ejecuta comandos shell y modifica archivos. Segun la linea base verificada del 2026-04-08, `strict` usa un backend real de sandbox con Docker y se bloquea si faltan Docker o la imagen requerida, mientras que `standard` sigue siendo un flujo local con guardrails. Revisá los cambios en una branch o worktree descartable antes de usar modo autonomo.\n\n## Documentacion Operativa\n\n- [AGENTS.md](AGENTS.md) — instrucciones locales para agentes de codigo\n- [docs/OPERATIONS.md](docs/OPERATIONS.md) — sistema de registro actual y comandos verificados\n- [docs/AUDIT_2026-04-07.md](docs/AUDIT_2026-04-07.md) — auditoria detallada y orden de remediacion\n- [docs/WEB_RESEARCH_2026-04-07.md](docs/WEB_RESEARCH_2026-04-07.md) — investigacion externa usada para estructurar la documentacion\n\n## Contribuir\n\nDamos la bienvenida a contribuciones. Ver [CONTRIBUTING.md](CONTRIBUTING.md) para las guías.\n\n- Reportes de bugs y solicitudes de features: [GitHub Issues](https://github.com/waitdeadai/forgegod/issues)\n- Preguntas y discusión: [GitHub Discussions](https://github.com/waitdeadai/forgegod/discussions)\n\n## Colaboradores\n\nForgeGod acredita públicamente trabajo de código y no-código.\n\n- [Matias Mesa](https://www.linkedin.com/in/matt-mesa/) - `design` - sistema oficial de mascota de ForgeGod\n- [WAITDEAD](https://waitdead.com) - `code`, `infra`, `research`, `projectManagement`, `maintenance`\n\nVer [CONTRIBUTORS.md](CONTRIBUTORS.md) para la lista actual de colaboradores.\n\n## Licencia\n\nApache 2.0 — ver [LICENSE](LICENSE).\n\n---\n\n\u003cp align=\"center\"\u003e\n  Construido por \u003ca href=\"https://waitdead.com\"\u003eWAITDEAD\u003c/a\u003e \u0026bull; Diseño oficial de la mascota por \u003ca href=\"https://www.linkedin.com/in/matt-mesa/\"\u003eMatias Mesa\u003c/a\u003e \u0026bull; Potenciado por técnicas de OpenClaw, Hermes, e investigación SOTA 2026 de agentes de código.\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaitdeadai%2Fforgegod","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwaitdeadai%2Fforgegod","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaitdeadai%2Fforgegod/lists"}