La guía de pixel.ceo.

01Primeros pasos

De una descarga nueva a tu primera misión firmada. Cuenta unos diez minutos, casi todos para iniciar sesión en un motor.

1. Instala pixel.ceo. Windows: ejecuta el instalador (puedes elegir la carpeta) o usa la versión portátil. Linux: da permiso de ejecución a la AppImage y ábrela (detalles).
2. Ten al menos un motor. Instala un CLI de agente e inicia sesión con tu propia cuenta — por ejemplo Claude Code o Codex. Si falta un CLI, pixel.ceo se ofrece a instalarlo.
3. Configura tu primera planta. El asistente pide, en orden: idioma, espacio del proyecto (un nombre y una carpeta local), coordinador, proveedor de IA y preferencias de la oficina.
4. Elige el coordinador. El coordinador (Marco por defecto) recibe tus encargos y los reparte en órdenes de trabajo. Elige un motor que pueda leer el buzón del equipo — Claude Code, Codex, Antigravity o Grok son buenas opciones — y un modelo capaz.
5. Contrata a tu primer agente. Pulsa «Contratar» y recorre Rol → Personaje → Motor → Proyecto → Contrato. Nada arranca hasta que pulsas «Contratar a {nombre}».
6. Envía una misión. Escribe al coordinador lo que quieres. Verás aparecer las órdenes en el tablero de misiones y a los agentes trabajar en la planta.
7. Responde y firma. Las preguntas llegan a una sola cola: A aprueba, D rechaza y «Permitir siempre» convierte la respuesta en regla. Revisa el informe de la misión al terminar.

02Instalar y actualizar

Windows

• Instalador PixelCEO-<versión>-win-x64-setup.exe: eliges dónde instalar; las actualizaciones llegan solas.
• Portátil …-win-x64-portable.exe: funciona sin instalar; te avisa cuando sale una versión nueva y tú la descargas.
• Si Windows muestra un aviso de SmartScreen con una descarga nueva, elige «Más información» y después «Ejecutar de todas formas».

Linux

Descarga PixelCEO-<versión>-linux-x86_64.AppImage, dale permiso de ejecución con chmod +x PixelCEO-*.AppImage y ábrela.

Actualizaciones

• La app revisa al abrir, cada 4 horas y cuando el equipo despierta. Descarga en segundo plano e instala solo cuando decides reiniciar.
• Puedes desactivar las actualizaciones automáticas en Ajustes → General.
• CLI de los motores: la app detecta versiones nuevas de tus CLI y te deja actualizarlos desde dentro.

Requisitos

03Motores

pixel.ceo no ejecuta ningún modelo: cada agente es uno de tus CLI, con tu propia cuenta y sus condiciones. Comprobar qué está instalado nunca inicia sesión ni hace una petición de pago.

«Solo como ayudante» significa que el motor no puede leer el buzón del equipo: se puede contratar como agente, pero no como coordinador. Los selectores de modelo muestran lo que ofrece hoy cada CLI instalado.

04Plantas, carpetas y worktrees

Una planta es un espacio de proyecto independiente: sus agentes, instrucciones, tareas y archivos. Para conectar un proyecto, crea una planta y apúntala a la carpeta local del proyecto («Añadir proyecto»).

Conectar un proyecto

1. Abre el selector de plantas y añade una.
2. Ponle nombre y elige la carpeta local de tu repositorio.
3. Elige su coordinador, su motor y la oficina que te guste.

Worktrees

Al contratar, «Aislamiento» ofrece dos opciones: Trabajar en la carpeta o Rama propia (worktree). Con un worktree el agente trabaja en su propia rama de git, lejos de la tuya. Los ayudantes temporales del coordinador usan uno por defecto. Un worktree con trabajo sin fusionar se conserva; nunca se borra.

Varias plantas

Abre tantas plantas como proyectos lleves y borra las que ya no necesites. Los datos de la planta viven como archivos normales en un repositorio git local dentro de su carpeta.

05Contratar y la ficha del agente

Cinco pasos

1. Rol — Desarrollo, Revisión, Pruebas, Documentación, Investigación o Personalizado.
2. Personaje — nombre, color y aspecto de la galería, o «Sorpréndeme».
3. Motor — el CLI, su modelo, la suscripción que queda y un tope de tokens. Avanzado: editar el comando.
4. Proyecto — la carpeta y el aislamiento: en la carpeta o en su propio worktree.
5. Contrato — accesos y límites, y luego «Contratar a {nombre}».

El menú Plantillas añade un equipo completo: equipos prediseñados, «Importar manifiesto…» o «Generar con IA». Un enlace de contratación (pixelceo://hire) solo rellena el formulario; tú confirmas.

La ficha del agente

Clic derecho en un agente, o Ajustes → Equipo. Seis pestañas: Identidad, Motor, Trabajo, Accesos, Límites e Historial.

• Accesos: qué herramientas MCP puede usar y si puede tocar archivos fuera de su carpeta.
• Límites: su propia autonomía (nunca por encima de la planta), tope de tokens, máximo de turnos, presupuesto diario y horario de trabajo.

06Misiones, preguntas y correo

Le das el encargo al coordinador; él lo reparte en órdenes y las asigna. Elige su motor y modelo en Ajustes → Equipo y modelos → «Motor del coordinador».

• Tablero de misiones: cada ficha muestra referencia, sello de estado, responsable y siguiente paso. Filtros, arrastrar y soltar, lista, resultados y archivo.
• Preguntas: cuando un agente necesita una decisión, espera en una sola cola. A aprueba, D rechaza; «Permitir siempre» crea una regla de aprobación.
• Informe de misión: ver los cambios, pedir revisión, crear un seguimiento, reabrir o archivar.
• Correo entre agentes: los agentes se escriben por buzones y un enrutador; el correo se entrega cuando quien lo recibe está en un punto de espera seguro.
• Subagentes que lanza un motor aparecen bajo su agente. También puedes forzar el arranque de una tarea en cola.
• Tu correo: conecta una cuenta IMAP/SMTP para leer y enviar correo desde la app.

07Modo Trabajo y atajos

Cambia con el botón Oficina / Trabajo de la barra superior, o pulsa F. En modo Trabajo la terminal del agente ocupa la pantalla y la oficina pasa a una ventana pequeña en la esquina. Las terminales son procesos reales sobre un panel de vidrio redimensionable; la herramienta Archivos añade un editor de código, los cambios git de cada agente, historial y comparación.

08La oficina

Editar oficina

Pulsa «Editar oficina» (en las cuatro oficinas principales). El catálogo tiene Espacios, Escritorios, Sillas, Mesas, Almacenaje, Plantas, Pantallas y Decoración, con 18 acabados de suelo y 10 de pared. Plantillas de espacio: oficina abierta, sala de reuniones, cafetería, despacho privado, zona de descanso, pasillos y una sala vacía.

R gira, Supr borra, Ctrl + Z / Y deshace y rehace, Esc suelta la selección. Clic derecho en una silla para asignarla como asiento de alguien.

Muebles que trabajan

• Despacho: misiones como carpetas en bandejas, un teletipo de cola y un cajón para las misiones cerradas.
• Pantalla de planta: cifras en directo; su «?» abre Preguntas y el resto abre la sala de servidores.
• Racks de servidores: al pasar el cursor, la cuota de la suscripción.
• Ascensor: los agentes llegan en ascensor al arrancar.

Estilo e idioma

Interfaz: Claro, Oscuro o Automático, con la paleta Circuit o Clásica y una escala del 90 al 125 %. Oficinas: Oficina principal, Loft industrial, Torre corporativa y Estudio creativo, más clima en directo y luz de día y de noche. Idiomas: English, Español, 简体中文 y العربية (de derecha a izquierda). La app nunca lee el idioma del sistema; lo eliges tú.

09Cuota y rendimiento

• Anillos de cuota: cada agente lleva un anillo con las ventanas de 5 horas y de 7 días de su suscripción, cuando el motor las informa. Solo toma color cuando queda poco. Un indicador en la barra superior y el tooltip del rack muestran lo mismo.
• Sala de servidores: CPU, RAM y suscripciones, incluido lo que usa cada agente.
• Topes por agente: tope de tokens, máximo de turnos y un presupuesto diario comparado con el gasto de hoy.
• Perfil Ligero: se elige solo con menos de 8 GB de RAM, menos de 1,5 GB libres al arrancar o sin GPU. La oficina va a 24 fps sin efectos, con historial de terminal más corto, una planta y dos ayudantes a la vez. «Usar gráficos ligeros» lo fuerza.

10Seguridad

Autonomía

Cada planta funciona en Preguntar primero, Autónomo o Sin restricciones (que pide confirmación). Tras un cambio, «Reiniciar N agentes ahora» lo aplica; cada agente retoma su sesión. «Quién puede contratar» es solo tú, o tú y el coordinador.

Reglas de aprobación

• Permite o prohíbe siempre un comando, para todos los agentes o uno, todos los proyectos o uno — hasta 200 reglas.
• Una regla de prohibición siempre gana a una de permiso. Los comandos encadenados deben coincidir exactamente con una regla.
• «Siempre» nunca aprueba comandos peligrosos como rm -rf, sudo, push --force, reset --hard, DROP TABLE o curl | sh.

Cortacircuitos

Activado por defecto. Guía, luego limita y al final detiene a un agente que repite la misma llamada (8 veces), entra en una tormenta de errores (5 errores) o dispara tokens (60 000 por minuto). Matar al agente al saltar viene apagado. También puedes fijar un presupuesto de tokens por planta y un máximo de turnos.

Secretos y pantallas

Los secretos de integraciones y tus claves de API se cifran en reposo con el almacenamiento seguro de tu sistema operativo. El modo visita oculta terminales, mensajes, git y memoria mientras alguien más ve tu pantalla.

Detener el trabajo hoy

Por agente: Pausar, «Parar tras este paso» o Despedir. Para toda la oficina: «Cerrar la oficina» → Cerrar ahora, o Forzar cierre.

11Automatizaciones e integraciones

Horarios

• Misiones programadas: cada cierto intervalo, o en días de la semana a una hora. La herramienta Automatizaciones también cubre el latido y la compactación automática programada.
• Cerrar la oficina (una vez): a una hora, en N minutos, cuando los agentes estén libres o cuando terminen las misiones; «Guardar y cerrar» o «Cierre forzado».
• Abrir al iniciar sesión y Mantener el equipo despierto.

Integraciones

• Slack: signing secret, token del bot y canal; tus agentes reciben órdenes desde ahí.
• Webhooks: varios, cada uno con su secreto y su modo (estricto, permitir todo o solo comunicación).
• Servidores MCP: sequential-thinking, time, fetch, context7, filesystem y git vienen encendidos; GitHub, bases de datos, correo y calendario y búsqueda se pueden activar.
• Chrome: Claude Code usa Chrome con su extensión oficial; Codex puede usar un navegador aislado o tu propio Chrome.
• Tus propios endpoints REST, en un registro que los agentes pueden usar.

12Modelos locales, claves y voz

Ajustes → Motores y CLI → «Claves y modelos locales».

• Tus claves de Anthropic, OpenAI, Google, OpenRouter y Groq, guardadas cifradas.
• Modelos locales: OpenCode, Crush, Pi y Qwen pueden apuntar a un servidor local — Ollama, LM Studio o vLLM. Incluye ajustes predefinidos para Ollama.
• Voz: dictado Free Flow con Groq Whisper (tu clave de Groq) y voz en tiempo real con el coordinador mediante OpenAI (tu clave de OpenAI). Incluye una prueba de micrófono.
• Memoria: memoria semántica con búsqueda y un grafo de conocimiento con tus documentos que los agentes pueden consultar.

13Privacidad y tus datos

• Sin telemetría: apagada en la compilación, sin interruptor.
• Sin cuenta: no hay nada que registrar.
• Una sola petición propia: buscar actualizaciones. Todo lo demás va solo a donde apuntes tus motores e integraciones.
• Tus datos: los ajustes de la app viven en tu perfil de usuario; los datos de cada planta, como archivos normales en un repositorio git local dentro de su carpeta.

14Próximamente

En la hoja de ruta, no en la 0.5. No hay fechas prometidas y el orden puede cambiar.

• Seguridad: «Parar todo» para cada agente, disparador y horario; tope diario por planta; sirena de agente atorado; archivos protegidos (.env, .git/, llaves SSH, almacén de secretos).
• Modo Trabajo con terminales divididas: hasta seis terminales, un panel con chats, misiones, Git, puertos, cuota y notas, y «traer a los que te esperan».
• Editor 2.0: sala inicial para un agente, salas estirables, una tarjeta por familia de mueble, rotación suave y modo de ensayo.
• Muebles interactivos: timbre de ayuda, buzón, pizarra de ideas, radio de la oficina, reloj checador, mesa de revisión, impresora de informes y la palanca «Parar todo».
• Pestaña de funciones experimentales en Ajustes → General, con lo que hace cada una y sus contras actuales.
• Estilo: ocho temas de interfaz y oficinas premium.
• pixel.ceo Pro: turno nocturno recurrente, informe semanal del directorio, plantillas de empresa y versiones anticipadas — el núcleo sigue gratis.

15Solución de problemas

• No aparece un motor: instala su CLI (la app puede hacerlo con la mayoría), inicia sesión una vez en una terminal y vuelve a abrir el formulario de contratación.
• Falta un modelo nuevo: actualiza ese CLI; los selectores muestran lo que ofrece la versión instalada.
• La oficina va lenta: activa «Usar gráficos ligeros» o el perfil Ligero.
• Un agente está en bucle: páusalo o usa «Parar tras este paso»; el cortacircuitos interviene por su cuenta.
• Necesitas irte ya: «Cerrar la oficina» → Cerrar ahora, o Forzar cierre.

¿Sigues atascado? Escríbenos a support@pixel.ceo.