🚀 Instalación y Primeros Pasos

Esta guía te acompañará en el proceso de instalación de Context Code, detallando los requisitos técnicos mínimos indispensables y la configuración de tu primera sesión interactiva de desarrollo.

---

📋 Pre-requisitos del Sistema

Antes de proceder con la instalación, asegúrate de que tu sistema cumpla con las siguientes condiciones mínimas recomendadas:

• Node.js: Versión 20.0.0 o superior (se recomiendan versiones activas o LTS estables como Node 22 o superior). Verifica tu versión actual ejecutando:

  node -v

  ¿Cómo actualizar o instalar Node.js?

  Si tu entorno cuenta con una versión de Node obsoleta o no la tienes instalada, cuentas con dos formas muy sencillas de resolverlo:

  • Opción A: Instalación Directa (Sencilla)

    • Descarga e instala el ejecutable oficial desde la página de Node.js (https://nodejs.org/). Te sugerimos descargar la versión marcada como LTS (Long Term Support).

  • Opción B: Mediante NVM (Node Version Manager - Muy Recomendado)

    • Windows: Descarga el instalador nvm-setup.exe de nvm-windows desde sus releases oficiales en GitHub. Abre una nueva consola y ejecuta:

      nvm install 22
      nvm use 22

    • macOS / Linux: Descarga e instala NVM mediante curl:

      curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

      Reinicia tu terminal y activa la última versión estable:

      nvm install 22
      nvm use 22
      nvm alias default 22

• Gestores de Paquetes: Un gestor compatible disponible globalmente en tu terminal:
  • pnpm (Versión 9.x o superior - muy recomendado por velocidad y gestión de dependencias monorepo).
  • npm (Versión 9.x o superior).
  • yarn (Versión 1.22.x o superior).
• Control de Versiones: Git instalado localmente. Esto te permitirá auditar, revisar y revertir con un simple git diff los parches precisos de código que genera el asistente.
• Entornos de Shell:
  • Windows: PowerShell 7+, Git Bash o la consola CMD estándar.
  • macOS / Linux: Bash o Zsh.
• Conexión a Red: Acceso a internet estable para la comunicación HTTPS externa con los proveedores cloud elegidos (salvo para flujos locales fuera de línea basados en Ollama).

---

📦 Instalación Global

Instala Context Code globalmente utilizando tu gestor de paquetes favorito. El paquete publicado en el registro de NPM es idéntico para todos los gestores:

pnpm

pnpm add -g @iaforged/context-code

npm

npm install -g @iaforged/context-code

yarn

yarn global add @iaforged/context-code

TIP

Nota para usuarios de Windows y pnpm: Si al ejecutar la instalación global con pnpm recibes el error ERR_PNPM_NO_GLOBAL_BIN_DIR, se debe a que pnpm necesita inicializar sus rutas globales. Resuélvelo de inmediato ejecutando:

pnpm setup

Después de ejecutar el comando, reinicia tu terminal para aplicar los cambios del PATH e instala de nuevo. Alternativamente, puedes usar npm install -g @iaforged/context-code para evitar cualquier paso de configuración extra.

---

🏃 Lanzamiento de Sesiones

Abre la terminal de comandos en el directorio raíz de tu proyecto e inicia una sesión interactiva:

context

El Lanzador context (Estándar)

Cuando ejecutas el comando context, la CLI arranca con optimizaciones en el motor de JavaScript:

• Aumenta el límite del heap de memoria a 8 GB (--max-old-space-size=8192).
• Esto garantiza que el analizador de contexto de Context Code pueda procesar repositorios extensos y mantener sesiones de desarrollo prolongadas sin caídas por falta de memoria RAM.

---

🛡️ Modo Autónomo (Bypass de Permisos)

Si estás trabajando en tareas repetitivas, refactorizaciones masivas o migraciones automáticas donde no quieres detenerte a confirmar manualmente cada edición de archivo o comando de terminal, puedes utilizar el binario hermano:

contextcode

¿Qué hace contextcode?

• Equivale a lanzar context --dangerously-skip-permissions.
• Salta automáticamente todos los prompts interactivos de permisos de archivos y consola.
• Los agentes de /agent y bucles autónomos de /objetivo se ejecutarán a la máxima velocidad posible sin intervenciones humanas.

WARNING

Utiliza contextcode únicamente en proyectos bajo control de versiones (Git) y con un estado limpio, para que puedas auditar y revertir cualquier cambio no deseado con facilidad.