Documentación de Arc OS
El Sistema de Orquestación para Equipos de IA. 70+ endpoints API. Dashboard CRM. Búsqueda semántica auto-hospedada (Cohere + sqlite-vec, Phase 71). Construido sobre Claude Code.
ℹ️ Phase 71 (2026-06-05): La búsqueda semántica ahora corre por pipeline RAG self-hosted (
shared/rag.ts+ Cohereembed-multilingual-v3.0+sqlite-vec). El bridge NotebookLM (Phase 36) fue descomisionado. Menciones a NotebookLM más abajo apuntan al setup antiguo; arquitectura actual: RAG Architecture (inglés — traducción pendiente).
Navegación Rápida
| Quiero... | Ir a |
|---|---|
| Ver qué hace Arc OS en 5 diapositivas | Funcionalidades Principales — 5 pilares + botón de tour |
| Aprender a usar el dashboard CRM | Guía de Usuario |
| Conectar mi máquina local a los workers CRM | Local Bridge CLI — sin dependencias, descarga y ejecuta |
| Usar ARC CLI para tareas, wiki y roadmap | Referencia ARC CLI — todos los comandos con ejemplos |
| Configurar bots de Telegram | Guía de Bots Telegram — Master Bot, Child Bot, enrutamiento de workers |
| Usar búsqueda semántica (NotebookLM) | NotebookLM Bridge — sincronización, búsqueda, niveles de memoria |
| Entender Workers y la Capa de Inteligencia | Workers e Inteligencia — Evals, Context Router, Learnings |
| Explorar la referencia de la API | Referencia API — 70+ endpoints con parámetros |
| Ver el esquema de la base de datos | Esquema de Base de Datos — 21+ tablas, 21 migraciones, diagrama ER |
| Configurar el entorno de desarrollo local | Configuración de Desarrollo — Bun, Node, puertos, variables de entorno |
| Diagnosticar un problema | Solución de Problemas — errores de auth, workers, bridge, frontend |
| Entender qué es Arc OS | Resumen del Producto |
| Ver qué problemas resuelve | Problemas y Soluciones |
| Comparar con otras herramientas | Análisis Competitivo |
| Aprender cómo funciona la Capa de Inteligencia | Los 4 Pilares |
| Ver especificaciones del sistema (snapshot Fase 21.5) | Informe del Sistema |
| Crear un nuevo skill | Crear Skills |
| Ejecutar varios proyectos sin mezclar contextos | Aislamiento de Skills Multi-Proyecto |
Por Sección
Producto
Qué es Arc OS, para quién está pensado y por qué existe.
- Resumen — Capacidades principales, resumen de arquitectura, cifras clave
- Problemas y Soluciones — 5 problemas reales que los desarrolladores enfrentan con las herramientas de IA y cómo Arc OS los resuelve
- Análisis Competitivo — Matriz de funcionalidades vs ChatGPT, Cursor, Windsurf, Devin. Comparaciones de casos de uso
Arquitectura
Cómo funciona el sistema bajo el capó.
- Workers y Capa de Inteligencia — 6 workers integrados, Binary Evals (6 tipos de reglas), Context Router, Learnings, Karpathy Loop (auto-mejora nocturna)
- Esquema de Base de Datos — 21+ tablas, 21 migraciones, claves foráneas, diagrama ER. Modo WAL SQLite, índices, pragmas
- Capa de Inteligencia — Los 4 Pilares — Binary Evals, Context Router, Reflect Loop, Karpathy Loop. Más Sage Worker y Marketplace Discovery
- Informe del Sistema — Fase 21.5 — Snapshot histórico: mapa de módulos, inventario de skills, detalles de infraestructura (Fase 21.5)
Guías
Instrucciones paso a paso para usar y extender el sistema.
- Guía de Usuario — Guía completa del dashboard CRM: login (OAuth, email, Telegram), workspace, workers, issues, wiki, skills, gestor de archivos, analítica, y más
- Referencia ARC CLI — Todos los comandos CLI: login, issues, skills, wiki, roadmap, report, memory, wrapup (cumplimiento de docs), github (vinculación de repo). Con ejemplos y variables de entorno
- Guía de Bots Telegram — Master Bot (orquestación) + Child Bot (proxy de IA). Comandos, teclados inline, enrutamiento de workers, integración CRM
- NotebookLM Bridge — Búsqueda semántica via Google AI. Auto-sincronización, caché de consultas, niveles de memoria, descarga de artefactos
- Local Bridge CLI — Bridge sin dependencias: descarga, pega el token, listo. Binarios standalone para Windows, macOS, Linux
- Local Bridge — macOS — Apple Silicon + Intel, flujo de Gatekeeper, install.command
- Local Bridge — Linux — x64 + arm64, extracción tar.gz, consejos de ripgrep
- Local Bridge — Windows — Windows 10/11, SmartScreen, peculiaridades del antivirus
- Crear Skills — Escribe skill.md, añade evals.json, registra en _registry.json, prueba el pipeline
- Aislamiento de Skills Multi-Proyecto — 3 niveles de aislamiento: CLAUDE.md, skills/, Context Router. Evals, learnings y métricas por proyecto
- Configuración de Desarrollo — Entorno de desarrollo local: Bun, Node, puertos, variables de entorno, Docker, estructura del proyecto
- Solución de Problemas — Diagnostica problemas de auth, worker, bridge, frontend y base de datos por síntoma
- Integración con GitHub — Notificaciones basadas en webhooks + feed en el sidebar para repos vinculados. HMAC-SHA256, multi-repo por proyecto, alertas Telegram (Fase 49.3)
- Configuración de Email — Runbook operacional para
[email protected]: Cloudflare Email Routing (gratis, 10 min), DMARC, ruta de migración a Zoho/Workspace
API
- Referencia CRM API — 70+ endpoints en 13 categorías: auth, projects, workers, files, skills, chat, wiki, analytics, marketplace, billing, invites, memory. Formatos de solicitud/respuesta, códigos de error, seguridad
Arquitectura (Profundización)
Arquitectura interna para usuarios avanzados — componentes, decisiones y análisis detallados por fase.
- Resumen de Arquitectura — Mapa del sistema de alto nivel con diagrama mermaid, lista de componentes, flujos de datos
- Fase 20 — Bots Federados — Arquitectura Master + Hijos, watchdog, vault
- Fase 45 — Zero-Knowledge E2EE — Derivación de claves PBKDF2, AES-256-GCM, claves de recuperación, caché en sessionStorage
- Flujo Dual-Agent — División Consultant + Developer, cola de specs, flujo de aprobación
- Inteligencia Evolutiva — Karpathy loop, inyección de learnings, mejora nocturna
- Backend CRM — Internos del servidor HTTP Bun, dispatch de rutas, primitivas SSE/WebSocket
Seguridad
- Resumen de Seguridad — Modelo de amenazas, resumen de hardening, smoke tests en tiempo de deploy
- Auditoría de Seguridad 2026-04-23 — Revisión multipaso de Sentinel, 13 parches, veredicto VERDE
Estado del Proyecto
- Roadmap — Timeline de fases (mermaid) + completo/en progreso/planificado para las 52 fases
- Resumen del Producto — Lista completa de funcionalidades (27), reducción v1→v2, para quién está pensado
Por Mecanismo
Encuentra documentación para una funcionalidad específica de Arc OS.
| Mecanismo | Qué hace | Docs |
|---|---|---|
| Binary Evals | Reglas declarativas que validan cada respuesta de IA | Capa de Inteligencia, Crear Skills |
| Context Router | Puntúa skills por mensaje, inyecta los top-5 como hints | Capa de Inteligencia, Informe del Sistema |
| Reflect Loop | Convierte Fix It / thumbs-down en reglas persistentes | Capa de Inteligencia |
| Karpathy Loop | Análisis nocturno de métricas, mejoras aprobadas por CEO | Capa de Inteligencia |
| Sage Worker | Analizador de skills con IA, benchmarks, marketplace discovery | Guía de Usuario |
| Sistema de Skills | Conjuntos de instrucciones portátiles con evals y registro | Crear Skills, Multi-Proyecto |
| Aislamiento de Proyectos | Child bots federados con contexto independiente | Multi-Proyecto, Resumen |
| Quality Tracking | Tasa de éxito por skill, feedback, métricas de duración | Informe del Sistema, Problemas |
| Learnings | Memoria de correcciones persistente por proyecto | Capa de Inteligencia, Multi-Proyecto |
| Skill Registry | Índice central con triggers, keywords, categorías | Crear Skills, Multi-Proyecto |
| Workers Dinámicos | Sistema extensible de workers de IA (tipos chat + terminal) | Guía de Usuario, Guía de Usuario |
| Adjuntos de Archivos | Subida de texto, imágenes y PDF a mensajes de workers | Guía de Usuario |
| Gestor de Archivos | Explorador de archivos del servidor con CRUD + git clone | Guía de Usuario |
| Issues | Rastreador de issues del proyecto con activity log | Guía de Usuario |
| Wiki | Base de conocimiento por proyecto con páginas markdown | Guía de Usuario |
| Knowledge Graph | Visualización interactiva de relaciones entre entidades | Guía de Usuario |
| Dashboard CRM | UI web para gestión de proyectos e interacción con IA | Guía de Usuario |
| Local Bridge | Relay WebSocket para acceso a archivos locales desde workers CRM | Local Bridge CLI |
| Cloud PM | Chat de proyecto persistente con Claude | Guía de Usuario |
| ARC CLI | Herramienta de línea de comandos para skills, issues, wiki, reports | Referencia ARC CLI, Guía de Usuario |
| Bots Telegram | Master (orquestación) + Child (proxy de IA por proyecto) | Guía de Bots Telegram |
| NotebookLM Bridge | Búsqueda semántica via Google AI, auto-sincronización | NotebookLM Bridge, Capa de Inteligencia |
| Sistema de Workers | 6 workers integrados con tools y modelos propios | Workers e Inteligencia |
| CRM API | 70+ endpoints REST con auth JWT | Referencia API |
| Seguridad y Cifrado | Base E2EE, cifrado en reposo, claves de recuperación | Arquitectura de Seguridad, Fase 45 E2EE |
| Integración GitHub | Notificaciones via webhook + feed en sidebar para repos vinculados | Configuración de Integración GitHub |
| Doc Enforcement | Hook pre-push + CLI arc wrapup para mantener docs sincronizadas |
Referencia ARC CLI |
| Base de Datos | SQLite con WAL, 21+ tablas, 21 migraciones | Esquema de Base de Datos |
| Solución de Problemas | Diagnostica problemas por síntoma | Solución de Problemas |
Estado de la Documentación
| Documento | Versión | Última Actualización |
|---|---|---|
| Guía de Usuario | 2.0 | 2026-04-15 |
| Referencia ARC CLI | 1.0 | 2026-04-27 |
| Guía de Bots Telegram | 1.0 | 2026-04-27 |
| NotebookLM Bridge | 1.0 | 2026-04-27 |
| Workers e Inteligencia | 1.0 | 2026-04-27 |
| Referencia API | 1.0 | 2026-04-27 |
| Esquema de Base de Datos | 1.0 | 2026-04-27 |
| Configuración de Desarrollo | 1.0 | 2026-04-27 |
| Solución de Problemas | 1.0 | 2026-04-27 |
| Resumen del Producto | 2.0 | 2026-04-15 |
| Problemas y Soluciones | 1.0 | 2026-04-03 |
| Análisis Competitivo | 2.0 | 2026-04-15 |
| Capa de Inteligencia | 2.0 | 2026-04-15 |
| Informe del Sistema 21.5 | 1.0 (histórico) | 2026-04-03 |
| Crear Skills | 1.0 | 2026-04-03 |
| Aislamiento Multi-Proyecto | 1.0 | 2026-04-03 |
| Local Bridge CLI | 2.0 | 2026-04-08 |