​

Base44 CLI

​

⚡ ACCIÓN INMEDIATA REQUERIDA - Lee esto primero

1. Comprueba si base44/config.jsonc existe en el directorio actual
2. Si SÍ (escenario de proyecto existente):
   • Transfiere a la habilidad base44-sdk para la implementación
   • Esta habilidad solo maneja comandos CLI (login, deploy, entities push)
3. Si NO, decide entre dos rutas de inicialización:
   • App aprovisionada — la app de Base44 ya existe porque acaba de aprovisionarse a través de un flujo Stripe Projects / projects.dev, O BASE44_APP_ID (o BASE44_PROJECTS_BASE44_APP_ID) está presente en el entorno o en un archivo .env/.env.local:
     • Ejecuta npx base44 scaffold para configurar los archivos locales para esa app existente
     • NO ejecutes npx base44 create — eso crea una segunda app duplicada. Consulta scaffold.md.
   • Nuevo proyecto — no existe ninguna app aún y ninguna fue aprovisionada:
     • Esta habilidad (base44-cli) maneja la solicitud; guía al usuario a través de npx base44 create
     • NO actives base44-sdk aún

​

Crítico: solo instalación local

• npx base44 <command> (npm - recomendado)
• yarn base44 <command> (yarn)
• pnpm base44 <command> (pnpm)

​

OBLIGATORIO: Comprobación de autenticación al inicio de la sesión

1. Comprobar el estado de autenticación ejecutando:
   npx base44 whoami
   
2. Si el usuario ha iniciado sesión (el comando tiene éxito y muestra un correo):
   • Continúa con la tarea solicitada
3. Si el usuario NO ha iniciado sesión (el comando falla o muestra un error):
   • DETENTE inmediatamente
   • NO procedas con ninguna operación CLI
   • Pide al usuario que inicie sesión manualmente ejecutando:
     npx base44 login
     
   - Espera a que el usuario confirme que ha iniciado sesión antes de continuar
   

​

Descripción general

​

Cuándo usar esta habilidad vs base44-sdk

• Crees un proyecto de Base44 NUEVO desde cero
• Inicialices un proyecto en un directorio vacío
• Configures archivos locales para una app existente que se aprovisionó externamente (por ejemplo, a través de un flujo Stripe Projects / projects.dev) → usa scaffold
• Al directorio le falta base44/config.jsonc
• El usuario menciona: “crear un nuevo proyecto”, “inicializar proyecto”, “configurar un proyecto”, “iniciar una nueva app de Base44”
• Desplegando, enviando entidades o autenticando mediante CLI
• Trabajando con comandos CLI (npx base44 ...)

• Construyas funciones en un proyecto de Base44 EXISTENTE
• base44/config.jsonc ya existe
• Escribas código JavaScript/TypeScript usando el SDK de Base44
• Implementes funcionalidad, componentes o funciones
• El usuario menciona: “implementar”, “construir una función”, “añadir funcionalidad”, “escribir código”

• base44-cli es un requisito previo para base44-sdk en nuevos proyectos
• Si el usuario quiere “crear una app” y no existe un proyecto de Base44, usa base44-cli primero
• base44-sdk asume que un proyecto de Base44 ya está inicializado

• SI (el usuario menciona “crear/construir app” O “hacer un proyecto”):
  • SI (base44/config.jsonc existe): → Usa base44-sdk (el proyecto existe, construye funciones)
  • SI NO SI (la app fue aprovisionada externamente — BASE44_APP_ID/BASE44_PROJECTS_BASE44_APP_ID está establecido, o un flujo Stripe Projects / projects.dev acaba de ejecutarse): → Usa base44-cli → npx base44 scaffold (configura archivos locales para la app existente; NO create)
  • SI NO: → Usa base44-cli → npx base44 create (se necesita inicialización de nuevo proyecto)

​

Estructura del proyecto

my-app/
├── base44/                      # Configuración de Base44 (creada por CLI)
│   ├── config.jsonc             # Configuración del proyecto, configuración del sitio
│   ├── .types/                  # Tipos TypeScript autogenerados (creado por `types generate`)
│   │   └── types.d.ts           # Augmentación de módulo para @base44/sdk
│   ├── entities/                # Definiciones de esquemas de entidades
│   │   ├── task.jsonc
│   │   └── board.jsonc
│   ├── functions/               # Funciones de backend (opcional)
│   │   └── my-function/
│   │       └── entry.ts
│   ├── agents/                  # Configuraciones de agentes (opcional)
│   │   └── support_agent.jsonc
│   └── connectors/              # Configuraciones de conectores OAuth (opcional)
│       └── googlecalendar.jsonc
├── src/                         # Código fuente del frontend
│   ├── api/
│   │   └── base44Client.js      # Cliente SDK de Base44
│   ├── pages/
│   ├── components/
│   └── main.jsx
├── index.html                   # Punto de entrada de SPA
├── package.json
└── vite.config.js               # O la configuración de tu framework

• base44/config.jsonc - Nombre del proyecto, descripción, configuración de compilación del sitio
• base44/entities/*.jsonc - Esquemas de modelo de datos (ver sección Esquema de entidad)
• base44/functions/*/entry.ts - Punto de entrada de función de backend
• base44/agents/*.jsonc - Configuraciones de agentes (opcional)
• base44/.types/types.d.ts - Tipos TypeScript autogenerados para entidades, funciones y agentes (creados por npx base44 types generate)
• base44/connectors/*.jsonc - Configuraciones de conectores OAuth (opcional)
• src/api/base44Client.js - Cliente SDK preconfigurado para uso frontend

{
  "name": "My App",                    // Requerido: nombre del proyecto
  "description": "App description",    // Opcional: descripción del proyecto
  "entitiesDir": "./entities",         // Opcional: por defecto "entities"
  "functionsDir": "./functions",       // Opcional: por defecto "functions"
  "agentsDir": "./agents",             // Opcional: por defecto "agents"
  "connectorsDir": "./connectors",     // Opcional: por defecto "connectors"
  "site": {                            // Opcional: configuración de despliegue del sitio
    "installCommand": "npm install",   // Opcional: instalar dependencias
    "buildCommand": "npm run build",   // Opcional: comando de compilación
    "serveCommand": "npm run dev",     // Opcional: servidor de desarrollo local
    "outputDirectory": "./dist"        // Opcional: directorio de salida de compilación
  }
}

​

Instalación

npm install --save-dev base44

npx base44 <command>

​

Opción global --app-id

# Ejecutar un script único contra una app específica
cat ./script.ts | npx base44 exec --app-id app_123

# Obtener registros para una app desplegada sin un checkout local
npx base44 logs --app-id app_123 --level error

• base44 create crea una nueva app, por lo que rechaza --app-id
• base44 dev se ejecuta desde un proyecto local vinculado, por lo que rechaza --app-id
• base44 deploy aún requiere un directorio de proyecto local porque lee recursos locales

​

Comandos disponibles

​

Autenticación

​

Gestión de proyectos

​

Desarrollo

​

Despliegue

​

Gestión de entidades

​

Esquema de entidad (referencia rápida)

{
  "name": "EntityName",
  "type": "object",
  "properties": {
    "field_name": {
      "type": "string",
      "description": "Field description"
    }
  },
  "required": ["field_name"]
}

​

Gestión de funciones

​

Gestión de agentes

​

Esquema de agente (referencia rápida)

{
  "name": "agent_name",
  "description": "Brief description of what this agent does",
  "instructions": "Detailed instructions for the agent's behavior",
  "tool_configs": [
    // Herramienta de entidad - da al agente acceso a operaciones de entidad
    { "entity_name": "tasks", "allowed_operations": ["read", "create", "update", "delete"] },
    // Herramienta de función de backend - da al agente acceso a una función
    { "function_name": "send_email", "description": "Send an email notification" }
  ],
  "whatsapp_greeting": "Hello! How can I help you today?"
}

• Los nombres de agente deben coincidir con el patrón: /^[a-z0-9_]+$/ (alfanumérico en minúsculas con guiones bajos, 1-100 caracteres)
• Válido: support_agent, order_bot
• Inválido: Support-Agent, OrderBot

• Herramientas de entidad: entity_name + allowed_operations (array de: read, create, update, delete)
• Herramientas de función de backend: function_name + description

​

Gestión de conectores

​

Esquema de conector (referencia rápida)

{
  "type": "googlecalendar",
  "scopes": [
    "https://www.googleapis.com/auth/calendar.readonly",
    "https://www.googleapis.com/auth/calendar.events"
  ]
}

​

Configuración de autenticación

​

Gestión de secretos

​

Ejecución de scripts

​

Generación de tipos

​

Gestión de sitio

​

Inicio rápido

1. Instala la CLI en tu proyecto:
   npm install --save-dev base44
   
2. Autentícate con Base44:
   npx base44 login
   
3. Crea un nuevo proyecto (SIEMPRE proporciona el nombre y la bandera --path):
   npx base44 create my-app --path .
   
4. Ejecuta el desarrollo local:
   npx base44 dev
   
5. Compila y despliega todo:
   npm run build
   npx base44 deploy -y
   

• npx base44 entities push - Envía solo entidades
• npx base44 functions deploy - Despliega solo funciones
• npx base44 functions delete <name> - Elimina una función desplegada
• npx base44 functions list - Lista todas las funciones desplegadas
• npx base44 functions pull - Extrae funciones desplegadas a archivos locales
• npx base44 agents push - Envía solo agentes
• npx base44 connectors pull - Extrae conectores de Base44
• npx base44 connectors push - Envía solo conectores
• npx base44 auth pull - Extrae la configuración de autenticación de Base44
• npx base44 auth push - Envía solo la configuración de autenticación
• npx base44 site deploy -y - Despliega solo el sitio

​

Flujos de trabajo comunes

​

Crear un nuevo proyecto

• Selección de plantilla - Elige la plantilla correcta (backend-and-client vs backend-only)
• Flujo de trabajo correcto - Diferentes plantillas requieren diferentes pasos de configuración
• Errores comunes - Evita errores de creación de carpetas que causen fallos

​

Vincular un proyecto existente

# Si tienes base44/config.jsonc pero no .app.jsonc
npx base44 link --create --name my-app

​

Ejecutar desarrollo local

# Inicia el backend de Base44 localmente
npx base44 dev

​

Desplegar todos los cambios

# Genera tipos (opcional, para proyectos TypeScript)
npx base44 types generate

# Compila tu proyecto primero
npm run build

# Despliega todo (entidades, funciones y sitio)
npx base44 deploy -y

​

Generar tipos TypeScript

# Genera tipos desde entidades, funciones, agentes y conectores
npx base44 types generate

​

Desplegar recursos individuales

# Enviar solo entidades
npx base44 entities push

# Desplegar solo funciones (todas)
npx base44 functions deploy
# Desplegar funciones específicas
npx base44 functions deploy my-function other-function
# Desplegar y podar funciones eliminadas
npx base44 functions deploy --force

# Enviar solo agentes
npx base44 agents push

# Extraer conectores de Base44
npx base44 connectors pull

# Enviar solo conectores
npx base44 connectors push

# Desplegar solo sitio
npx base44 site deploy -y

​

Abrir el panel

# Abrir el panel de la app en el navegador
npx base44 dashboard

​

Autenticación

​

Solución de problemas