Arc OS Docs Open in app →

Arc OS — Guía de usuario

Guía completa de todas las funciones del CRM Dashboard de Arc OS. Última actualización: 2026-05-04 (Phase 52.1)

Mapa de funciones de un vistazo

graph LR
    Login[1. Login + código de invitación]
    Dash[2. Vista de todos los proyectos]
    Onb[3. Asistente de creación de proyecto]
    Work[4. Workspace + Workers]
    Time[5. Reproducción en Timeline]
    Iss[6. Issues rediseñado]
    Skill[7. Skills + Sage]
    Wiki[8. Wiki + KG]
    NB[9. NotebookLM]
    Bill[10. Período de prueba + Facturación]

    Login --> Dash --> Onb --> Work
    Work --> Time
    Work --> Iss
    Work --> Skill
    Work --> Wiki --> NB
    Dash --> Bill

Tabla de contenidos

  1. Primeros pasos
  2. Estructura del dashboard
  3. Workspace — Workers de IA
  4. Adjuntos de archivos
  5. Carpetas — Gestor de archivos
  6. Worker Studio — Workers personalizados
  7. Issues
  8. Wiki
  9. Knowledge Graph
  10. Skill Evolution
  11. Roadmap
  12. Informes
  13. Analytics
  14. NotebookLM — Memoria neural
  15. Cloud PM — Chat del proyecto
  16. Configuración del proyecto
  17. Integración con Telegram
  18. Tema y configuración
  19. Atajos de teclado
  20. Troubleshooting
  21. Timeline (Phase 47)
  22. Créditos de prueba y facturación
  23. Acceso beta — Códigos de invitación

1. Primeros pasos

Beta restringida (Phase 52.1): El registro público es actualmente solo por invitación. Necesitas un código de invitación con el formato arc-XXXX-XXXX para crear una cuenta. Ver §23 Acceso beta para obtener uno.

Flujo de onboarding — Storyboard

sequenceDiagram
    autonumber
    actor U as Tú
    participant L as Pantalla de login
    participant E as Email
    participant W as Asistente de onboarding
    participant M as Master Bot
    participant Wo as Workspace

    U->>L: pega el código arc-XXXX-XXXX
    L->>L: valida formato
    U->>L: introduce email + contraseña + nombre
    L-->>E: envía enlace de verificación (TTL 24h)
    U->>E: hace clic en el enlace de verificación
    E->>L: redirige → sesión iniciada
    L->>W: usuario primerizo → asistente
    U->>W: nombre del proyecto · elige blueprint · introduce clave Anthropic (opcional)
    W->>M: POST /api/crm/onboarding/setup
    M->>M: allocatePort() · crea dirs · clona blueprint · inicia child bot
    M-->>W: proyecto listo
    W->>Wo: redirige a /project/<name>
    U->>Wo: envía el primer mensaje
    Wo-->>U: transmite tokens por SSE

Presupuesto de tiempo: objetivo ≤10 min desde pegar el código hasta la primera respuesta de IA. Pasos 1-5 ≈ 3 min, pasos 6-9 ≈ 2 min, primer chat ≈ 1-5 min según el clone del blueprint.

Login

Arc OS admite tres métodos de autenticación:

Opción A: Email y contraseña

  1. Abre el CRM dashboard (https://arc-os.co o http://<server>:18888).
  2. Haz clic en Create Account en la pantalla de login.
  3. Introduce tu email, nombre visible, contraseña y tu código de invitación (arc-XXXX-XXXX).
  4. Verifica tu email mediante el enlace enviado a tu bandeja de entrada (TTL 24h).
  5. Inicia sesión con email y contraseña.

Opción B: OAuth (Google / GitHub)

  1. Abre la pantalla de login del CRM.
  2. Haz clic en Continue with Google o Continue with GitHub.
  3. Autoriza en la ventana emergente.
  4. Se te redirigirá de vuelta y quedarás autenticado automáticamente.

Todos los métodos generan un token JWT (válido 24 horas) almacenado en tu navegador.

Primeros pasos

Tras iniciar sesión verás la vista All Projects. Usa el selector de workspace en el encabezado para cambiar entre proyectos, o haz clic en All Projects para ver el dashboard global.

2. Estructura del dashboard

Encabezado superior

Elemento Descripción
Menú hamburguesa Mostrar/ocultar sidebar (borde izquierdo)
Selector de workspace Desplegable para cambiar entre proyectos y la vista global "All Projects"
Indicador de conexión Punto verde = conectado, rojo = desconectado
Toggle de tema Cambiar modo claro/oscuro
Menú de usuario Perfil, Configuración de cuenta, Cerrar sesión

Sidebar

Menú de navegación colapsable (haz clic en el hamburguesa para togglearlo). Móvil: cajón superpuesto con fondo.

Páginas globales (visibles desde All Projects):

Páginas de proyecto (visibles cuando hay un proyecto seleccionado):

ContextRail (Panel derecho, ≥1280px)

Un panel lateral derecho de 320px que muestra el contexto del proyecto junto a la página activa. Secciones:

3. Workspace — Workers de IA

El Workspace es tu interfaz principal para interactuar con la IA. Usa un sistema de Dynamic Workers donde cada worker es un agente de IA especializado.

Workers integrados

Worker Tipo Modelo Propósito
Consultant Chat Sonnet Análisis de solo lectura, consejos de arquitectura, propuestas de spec
Developer Terminal Opus Edición completa de código, operaciones de archivos, comandos bash

Barra de workers

En la parte superior del Workspace verás pills (botones) de workers:

Workers de chat (Consultant)

Interfaz de burbujas estilo chat:

Workers de terminal (Developer)

Interfaz de flujo de log de terminal:

Selector de modelo

En la barra inferior de cada panel de worker:

Acciones rápidas (barra inferior)

Botón Acción
/btw Añadir nota de contexto — pide texto, se antepone al siguiente mensaje
Pause Pausar el subprocess Claude actual (SIGSTOP)
Stop Terminar el subprocess Claude actual (SIGKILL)
Approve Last Envía /approve al developer para el último spec

4. Adjuntos de archivos

Puedes adjuntar archivos a cualquier mensaje de worker.

Cómo adjuntar

  1. Haz clic en el icono de clip en el área de entrada de mensajes, O
  2. Arrastra y suelta archivos en el workspace, O
  3. Pega una imagen desde el portapapeles

Tipos de archivo admitidos

Tipo Extensiones Cómo se procesa
Texto/Código .txt, .md, .py, .js, .ts, .jsx, .tsx, .css, .html, .json, .yaml, .sh, .sql, .csv, .go, .rs, .java, .c, .cpp, .rb, .php, etc. Se lee como texto, el contenido se inyecta en el mensaje
Imágenes .png, .jpg, .jpeg, .gif, .webp, .svg, .bmp Se comprime a JPEG (máx. 1600px, calidad 80%), se muestra como miniatura
PDF .pdf Se lee como base64, se guarda como archivo temporal en el servidor, la ruta se inyecta en el prompt

Chips de adjunto

Tras adjuntar, los archivos aparecen como chips sobre el campo de entrada:

Límites de tamaño

5. Carpetas — Gestor de archivos

La página Folders proporciona un navegador completo de archivos del directorio de tu proyecto en el servidor.

Navegación

Acciones de la barra de herramientas

Acción Descripción
Upload Subida de múltiples archivos (botón o arrastrar y soltar)
New Folder Crea un nuevo directorio (introduce el nombre)
New File Crea un archivo con contenido inicial opcional
Add Link Crea un archivo bookmark .link.md (URL + texto)
Clone Repo Clona un repositorio Git (URL HTTPS, --depth 1 shallow)

Menú contextual (clic derecho)

Haz clic derecho en cualquier elemento para ver opciones adicionales:

En archivos:

En carpetas:

En espacio vacío:

Panel de previsualización de archivos

Al hacer clic en un archivo se abre un panel lateral que muestra:

6. Worker Studio — Workers personalizados

Puedes crear workers de IA personalizados adaptados a las necesidades de tu proyecto.

Crear un worker

  1. En el Workspace, haz clic en el icono de engranaje (Worker Studio) en la barra de workers
  2. Haz clic en + New Worker
  3. Completa la configuración del worker:
Campo Descripción
Label Nombre visible (p. ej., "QA Tester")
Icon Emoji del pill del worker
Type Chat (estilo conversación) o Terminal (flujo de log)
Model Modelo de IA a usar (Sonnet, Opus, Haiku)
Max Turns Máximo de turnos del subprocess Claude (1-50)
Tools Herramientas que puede usar el worker (Read, Edit, Bash, etc.) o "all"
Focus Dirs Directorios en los que debe centrarse el worker
System Prompt Instrucciones del sistema personalizadas para el worker
Context Assets Archivos/directorios cargados automáticamente como contexto

Prompts del sistema generados por IA

Haz clic en Generate with AI para crear automáticamente un prompt del sistema basado en:

Token del bot de Telegram

Cada worker puede tener su propio bot de Telegram dedicado:

  1. Edita un worker en Worker Studio
  2. En la sección Telegram Bot Token, pega un token de bot (de @BotFather)
  3. Haz clic en Connect
  4. El bot del worker se inicia automáticamente y gestiona los mensajes de forma independiente
  5. Para eliminarlo: haz clic en Disconnect

Esto permite bots de Telegram por worker — p. ej., un bot Consultant con acceso de solo lectura y un bot Developer con acceso completo.

Gestionar workers

7. Issues

La página Issues es un rastreador de issues completo para tu proyecto.

Funciones

Desde el CLI

Los issues también pueden gestionarse mediante el ARC CLI:

arc issues                         # listar issues abiertos
arc issue create --title "Bug..." # crear nuevo issue
arc issue log <id> "Fixed X"      # añadir entrada al log de actividad

8. Wiki

La página Wiki es la base de conocimiento de tu proyecto.

Funciones

9. Knowledge Graph

La página Graph visualiza las relaciones entre entidades del proyecto (issues, páginas wiki, skills, fases del roadmap) como un grafo de nodos interactivo.

10. Skill Evolution

La página Skill Evolution (llamada "Skills" en la sidebar del proyecto, "Skills Registry" en la sidebar global) proporciona una gestión avanzada de skills.

Diseño de dos paneles

Sage Worker

El Sage es un analizador de skills potenciado por IA:

Forks de skills

Haz un fork de una skill global para personalizarla para un proyecto concreto. El fork rastrea la skill padre y puede traer actualizaciones.

11. Roadmap

La página Roadmap muestra el plan de desarrollo del proyecto organizado por fases.

12. Informes

La página Reports muestra analytics e informes de sesión.

13. Analytics

La página Analytics (vista global) muestra el estado y las métricas del sistema:

14. NotebookLM — Memoria neural

Si tu proyecto tiene notebooks de NotebookLM vinculados, aparecen en el pie de la sidebar bajo "Neural Memory":

La página global NotebookLMs muestra todos los notebooks vinculados entre proyectos.

15. Cloud PM — Chat del proyecto

El Cloud PM es un chat de proyecto persistente accesible desde el Workspace:

16. Configuración del proyecto

La página Project Settings (accesible mediante el botón Settings en la sidebar) proporciona:

17. Integración con Telegram

El bot de Telegram es una interfaz de comandos alternativa. Todas las funciones del CRM dashboard son también accesibles desde Telegram.

Comandos del Master Bot

Comando Descripción
/status Resumen del sistema (estado de todos los proyectos)
/list Lista de todos los proyectos registrados
/health Health check detallado de todos los bots
/watchdog Estado del watchdog y monitoreo de child bots
/new_project <name> Asistente interactivo de creación de proyecto
/deploy Desplegar actualizaciones al VPS
/emergency_stop Detener todos los child bots inmediatamente

Comandos del Child Bot

Comando Descripción
/ping Health check del bot
/thread Tamaño del historial del hilo
/quality Informe de métricas de calidad de skills
/learnings Ver reglas de corrección acumuladas
/specs Ver specs pendientes
/approve <id> Aprobar un spec
/reject <id> [reason] Rechazar un spec

Enrutamiento de mensajes

Prefijo Se enruta a
/c <mensaje> Worker Consultant
/d <mensaje> Worker Developer
/w:<worker_id> <mensaje> Worker personalizado por ID
(sin prefijo) Rol activo (por defecto: consultant)

Bots de Telegram por worker

Cada worker puede tener su propio token de bot de Telegram (configurado en Worker Studio). Cuando un worker tiene su propio bot:

Botones inline

Tras cada respuesta del bot aparecen botones inline:

18. Tema y configuración

Modo oscuro/claro

Haz clic en el toggle de tema en el encabezado superior para cambiar entre los temas claro y oscuro. Tu preferencia se guarda en localStorage.

Configuración de cuenta

Haz clic en tu avatar → Account Settings para configurar:

Sistema de colores

El dashboard usa propiedades personalizadas de CSS para un tema consistente:

Colores de estado

Color Significado
Verde Saludable / Éxito / Online
Amarillo/Naranja Degradado / Advertencia / Procesando
Rojo Caído / Error / Fallido
Morado Thinking / Spec draft
Azul Ejecutando / Activo

19. Atajos de teclado

Atajo Contexto Acción
Enter Campo de mensaje Enviar mensaje
Shift+Enter Textarea de chat Nueva línea
Escape Cualquier modal Cerrar modal/overlay
Clic derecho Navegador de archivos Menú contextual

20. Troubleshooting

"Connection lost" / Indicador rojo

El dashboard perdió la conexión con el servidor. Comprueba:

  1. ¿Está el VPS funcionando? (conecta por ssh al servidor, comprueba tmux ls)
  2. ¿Está nginx funcionando? (systemctl status nginx)
  3. ¿Está el master bot funcionando? (curl http://<server>:19210/api/master/health)

"Unauthorized" / Bucle de login

Tu token JWT ha caducado (TTL 24h). Inicia sesión de nuevo con email/contraseña u OAuth.

El panel del worker no muestra salida

  1. Comprueba que el stream SSE esté conectado (DevTools del navegador → Network → filtra por EventStream)
  2. El worker puede que todavía no haya producido salida — envía primero un mensaje
  3. Prueba a recargar la página (F5)

La subida de archivo falla

El bot no responde en Telegram

  1. Comprueba el estado del bot: envía /ping
  2. Si no hay respuesta, conéctate por SSH al VPS y comprueba tmux: tmux attach -t citadel-child
  3. Comprueba los logs: tail -50 /var/log/citadel/<project>/system-$(date +%Y-%m-%d).log
  4. Reinicia desde el CRM: Project Settings → Restart Bot, o /deploy en el Master Bot

Errores CORS en la consola del navegador

El dominio del dashboard debe estar en CRM_ALLOWED_ORIGINS. Por defecto se permiten:

invite_required 403 al registrarse (Phase 52.1)

El registro público está restringido. Opciones:

plan_limit_reached 402 al crear proyecto / worker (Phase 51)

Tu cuenta alcanzó el límite de tu tier:

Haz upgrade desde Settings → Billing (la UI de Stage 3 está en curso). Por ahora contacta al CEO.

21. Timeline (Phase 47)

Una página de observabilidad estilo DAW que te permite reproducir la sesión de un worker como si fuera una consola de mezcla de audio.

sequenceDiagram
    participant U as Tú
    participant W as Workspace
    participant T as Timeline
    participant DB as tabla timeline_events

    U->>W: envía mensaje al Worker A
    W->>DB: añade eventos (think · tool · response)
    U->>T: abre la página Timeline
    T->>DB: consulta eventos agrupados por worker
    T-->>U: renderiza carriles + playhead
    U->>T: mueve el playhead / mute/solo de carriles

Funciones

Cuándo usar

22. Créditos de prueba y facturación (Phases 50-51)

Arc OS usa la API de Anthropic en tu nombre para los workers de chat/terminal. La plataforma base es gratuita, pero los costes de tokens se trasladan a tu cuenta.

Créditos de prueba (Phase 50)

Facturación con Stripe (Phase 51 — Stage 1 activo, UI de Stage 3 pendiente)

Plan Precio Proyectos Workers
Free $0 1 5
Min $4.99/mes 5 O 25 (semántica OR) semántica OR
Max $11.99/mes 20 O 150 semántica OR
Beta manual Infinity Infinity

Límites semánticos OR: "5 O 25" significa que puedes tener ≤5 proyectos O ≤25 workers entre todos los proyectos — lo que alcances primero.

Usar tu propia clave

Si prefieres pagar directamente a Anthropic:

  1. Obtén una clave API de Anthropic en https://console.anthropic.com
  2. Account Settings → API Keys → pega la clave
  3. O usa el Local Bridge CLI para ejecutar workers en tu propia máquina de forma gratuita

endpoint de estado

GET /api/crm/billing/status devuelve:

23. Acceso beta — Códigos de invitación (Phase 52.1)

Arc OS está en beta de Friends & Family. El registro público está cerrado hasta que se validen los criterios de éxito del F&F.

Obtener una invitación

Formato del código

arc-XXXX-XXXX — prefijo arc- + 8 caracteres hexadecimales en dos grupos con guión (derivados de crypto.randomBytes).

Usar un código

  1. Ve al formulario de registro
  2. Pega el código en el campo Invite Code (entrada monospace, validada en el cliente)
  3. El código se consume atómicamente al registrarse con éxito — un código por cuenta
  4. Si el código ya está en uso o fue revocado: 403 invite_required con un enlace al canal de feedback

Beneficios del Founding Member

Admin: generar y revocar códigos (solo CEO)

arc invites generate --count 5            # generar 5 códigos nuevos
arc invites list                          # mostrar códigos activos + quién los usó
arc invites revoke arc-AAAA-BBBB          # invalidar un código filtrado

Equivalentes REST: POST/GET/DELETE /api/crm/admin/invites (requiere rol admin).

Mantenido por el equipo de Arc OS. Actualizado tras cada fase completada.