# Instalar y conectar

Necesitas una cuenta de EditorBrain, Node.js 22 o superior y el agente que usarás instalado. Para desarrollo del repositorio usamos Node.js 24. Tu acceso a Claude Code o Codex se administra por separado.

## 1. Prepara tu espacio

Entra a [EditorBrain](https://editorbrain.com/login), completa el onboarding y crea un proyecto en tu marca. Conserva el identificador que aparece al consultar los proyectos. No tienes que repetir la configuración de marca para cada video.

## 2. Instala el CLI

Esta guía corresponde a **0.49.1**, publicada y verificada en npm y API.
Consulta [Versiones y disponibilidad](https://editorbrain.com/docs/versiones) y conserva las instrucciones
personalizadas de tu agente al actualizar.

```sh
npm view editorbrain@0.49.1 version
npm install -g --ignore-scripts --no-audit --no-fund editorbrain@0.49.1
editorbrain version
editorbrain help
```

Sin instalación global, puedes ejecutar un comando con una versión fija:

```sh
npx --yes --ignore-scripts --package=editorbrain@0.49.1 editorbrain version
```

## 3. Conecta y elige el proyecto

```sh
editorbrain login
editorbrain status
editorbrain brands list
editorbrain projects list
```

El navegador pide tu autorización. No pegues claves, cookies ni códigos en el chat. Si no se abre automáticamente, usa `editorbrain login --no-browser` y sigue el enlace que devuelve.

En la versión publicada, la credencial está vinculada al espacio autorizado. Las marcas de ese espacio se manejan con la misma conexión. Autorizar todos los espacios de una cuenta está en desarrollo; no lo asumas disponible.

## 4. Instala las instrucciones para tu agente

Sustituye `mi-proyecto` por el ID real, no por el título visible:

```sh
editorbrain setup --dir ./mis-videos --agent claude --project mi-proyecto
```

Para Codex cambia `--agent claude` por `--agent codex`; `both` prepara ambos. `setup` conserva configuraciones existentes y puede indicar `action_required` si falta autorizar el MCP dentro del agente. Termina solo ese paso; no repitas toda la instalación.

Si trabajas únicamente con el CLI, añade `--skip-mcp`. La configuración de MCP y la autorización del CLI son conexiones independientes.

## 5. Comprueba la conexión

```sh
editorbrain doctor --dir ./mis-videos --agent both
```

Dentro del agente, pide que consulte `workspace_info` si usa MCP. El espacio debe coincidir con `editorbrain status`. Un diagnóstico correcto no garantiza que haya un motor de render o una integración externa lista: revisa las capacidades que devuelve.

## Sin conexión o sin cuenta

Puedes preparar archivos e instrucciones locales:

```sh
editorbrain init --dir ./prueba-local --brand mi-marca --project demo --agent both
editorbrain doctor --dir ./prueba-local --offline
```

Eso no crea una cuenta, no autoriza la biblioteca privada ni sube archivos. Si después conectas esa carpeta, revisa los cambios de sincronización para no mezclar marcas.

## Actualizar después

Instalar una versión nueva con npm no vuelve a escribir por sí solo los skills de tus proyectos. En versiones que lo incluyen, `editorbrain update` coordina CLI y skills. Después, recarga los skills o abre un chat nuevo: una conversación abierta puede seguir usando instrucciones antiguas.

Lee [Versiones y disponibilidad](https://editorbrain.com/docs/versiones) antes de usar opciones avanzadas del actualizador. Para un proyecto concreto también puedes instalar explícitamente los skills con el CLI elegido:

```sh
editorbrain skill install --dir ./mis-videos --agent both
editorbrain skill list
```

Las instrucciones personalizadas se conservan y los conflictos se reportan; no los resuelvas borrando tu carpeta.