Primeros pasos con Arc OS

Arc OS — Sistema de Orquestación de IA para equipos de desarrollo. Esta guía explica qué es Arc OS, por qué existe y cómo empezar a usarlo de forma efectiva.

¿Qué es Arc OS?

Arc OS es una plataforma que te permite construir y gestionar un equipo personal de desarrollo de IA sobre Claude.

La idea central: en lugar de abrir un chat de IA nuevo cada vez que necesitas ayuda, tienes workers de IA persistentes que:

Conocen tu codebase, tu arquitectura y tu historial
Nunca pierden el contexto entre sesiones
Se especializan cada uno en un rol específico
Comparten la misma base de conocimiento del proyecto

Construyes tu equipo una vez. Luego trabajas con él — vía CLI, IDE o web.

La idea principal: un LLM, contexto compartido, roles especializados

La mayoría de los desarrolladores usan la IA como un chat desechable — pegas código, obtienes respuesta, lo olvidas.

Arc OS es diferente:

Un LLM (Claude) — todos los workers corren sobre Claude. Elegimos Claude por su ventana de contexto larga, su seguimiento de instrucciones y su calidad de código. Tú aportas tu propia suscripción de Claude.

Sin pérdida de contexto — cada worker tiene acceso a:

La wiki de tu proyecto (decisiones de arquitectura, convenciones, notas)
Tus skills (instrucciones personalizadas para tareas específicas)
Tu tracker de issues (qué se está trabajando, qué está hecho)
El historial de sesiones (qué se discutió antes)

Roles especializados — cada worker tiene una personalidad, permisos y propósito distintos:

Worker	Rol	Qué hace
Developer	Acceso completo	Escribe código, ejecuta comandos, hace commits, depura
Consultant	Solo lectura	Revisa, explica, asesora — nunca toca archivos
Designer	Enfoque UI/UX	Diseño de componentes, accesibilidad, sistemas visuales
Sentinel	Seguridad	Audita código, encuentra vulnerabilidades, endurece sistemas
Archivist	Documentación	Escribe docs, mantiene la wiki al día, genera informes
Product Owner	Planificación	Gestiona el roadmap, crea issues, prioriza el backlog

También puedes crear workers personalizados para tus necesidades específicas.

¿Qué es un proyecto?

Un proyecto en Arc OS corresponde a un codebase o producto en el que trabajas.

Cada proyecto tiene:

Su propio conjunto de workers (Developer, Consultant, etc.)
Su propia wiki (docs de arquitectura, decisiones, convenciones)
Sus propios skills (instrucciones personalizadas inyectadas en los workers)
Su propio tracker de issues (tareas, bugs, funcionalidades)
Su propio historial de sesiones

Puedes tener varios proyectos — uno por producto, cliente o repositorio.

La forma principal de trabajar: CLI Bridge

El CLI bridge es la interfaz principal de Arc OS. Conecta tu terminal local o IDE directamente con tus workers de IA.

# Start a Developer session on project "my-app"
arc my-app developer

# Start a Consultant (read-only) session
arc my-app consultant

# Continue the previous session (restores context)
arc my-app developer continue

Cuando ejecutas arc <project> <worker>, el worker:

Carga la wiki de tu proyecto, los skills y el issue activo
Abre una sesión interactiva de Claude en tu terminal
Tiene acceso completo a tu sistema de archivos local (Developer) o solo lectura (Consultant)
Guarda el contexto de la sesión para la próxima vez

¿Por qué CLI-first?

Funciona en cualquier terminal (macOS, Linux, Windows)
Se integra con VS Code, Cursor y JetBrains vía el panel de terminal
Sin cambios de contexto — te quedas en tu editor
Consciente de Git: el worker ve tu rama actual, los cambios en staging y los commits recientes

Comandos clave de arc CLI

arc <project> <worker>               # Start a session
arc <project> <worker> continue      # Resume previous session
arc sessions <project>               # Browse past sessions
arc issues                           # List open issues
arc issue create --title "..."       # Create new issue
arc issue log <id> "progress note"   # Log progress
arc skill <name>                     # Load a skill into context
arc wiki                             # Browse project wiki
arc roadmap                          # View project roadmap
arc retro <project>                  # Reconstruct issues from history

Cómo empezar

Paso 1 — Instala arc CLI

Descarga el binario para tu sistema operativo desde el dashboard de Arc OS (Settings → CLI).

# macOS / Linux
chmod +x arc-linux-x64
sudo mv arc-linux-x64 /usr/local/bin/arc
arc --version

Paso 2 — Crea tu primer proyecto

En el CRM dashboard:

Haz clic en New Project
Dale un nombre y conecta tu repositorio de GitHub
El sistema crea tu equipo de workers automáticamente

Paso 3 — Añade skills (opcional pero recomendado)

Los skills son conjuntos de instrucciones personalizadas que hacen a los workers más inteligentes sobre tu proyecto:

Convenciones de estilo de código
Patrones de arquitectura que usas
Librerías y frameworks de tu stack
Cosas que el worker debe hacer siempre / nunca

Ve a Skill Registry → Generate — el sistema lee tu codebase y sugiere skills automáticamente.

Paso 4 — Inicia tu primera sesión

arc my-project developer

El worker Developer se presentará, cargará el contexto de tu proyecto y esperará tu primera tarea.

Paso 5 — Conecta Telegram (opcional)

Si quieres enviar mensajes rápidos a los workers desde tu teléfono o cuando estés lejos del ordenador, conecta Telegram vía Settings → Telegram Bot.

Telegram es opcional — toda la funcionalidad principal funciona a través del CLI.

Cómo comparten conocimiento los workers

Todos los workers del mismo proyecto comparten:

Wiki — documentos markdown que tú o los workers escriben sobre el proyecto. Decisiones de arquitectura, convenciones de API, "cosas que hay que saber", notas de onboarding. Los workers leen la wiki automáticamente al inicio de la sesión.

Skills — conjuntos de instrucciones reutilizables. Un skill de "TypeScript strict mode" o de "siempre escribe los tests primero" se inyecta en cada sesión de worker relevante.

Issues — cuando un worker trabaja en el issue #42, conoce ese contexto. Otros workers pueden ver qué se está trabajando.

Historial de sesiones — los workers pueden consultar lo discutido en sesiones anteriores vía arc sessions o continue.

Standard Cloud — Workspace siempre activo

Standard Cloud ya está disponible. Con una suscripción Standard Cloud obtienes un contenedor Docker dedicado en los servidores de Arc OS (Hetzner).

Qué te aporta

Archivos de proyecto persistentes en el VPS Tu directorio /workspace vive en el servidor — no en tu portátil. Los archivos están ahí cuando vuelves, incluso después de cerrar tu ordenador.

/workspace/my-project/   ← your code, always available
/home/arcuser/.claude/   ← Claude auth, persisted
/home/arcuser/.ssh/      ← GitHub SSH key, persisted

Sincronización con GitHub vía SSH El contenedor tiene una clave SSH dedicada conectada a tu cuenta de GitHub. Haces git clone una vez — luego git pull / push desde cualquier lugar sin volver a autenticarte.

# Inside your container workspace
cd /workspace
git clone [email protected]:you/project.git   # once
git pull                                    # any time, from any device

Acceso desde cualquier dispositivo Abre el CRM de Arc OS desde el teléfono, la tablet u otro ordenador — tu workspace y tus archivos están exactamente donde los dejaste. Sin el problema de "dejé el proyecto en mi otra máquina".

Continúa donde lo dejaste

# In Telegram, next morning:
/continue

# Worker responds:
# Yesterday: finished auth middleware, tests remaining
# Continuing...

El worker retoma el contexto de la sesión anterior y sigue trabajando — mientras tú te tomas el café.

Qué incluye

Funcionalidad	Free / Local	Standard Cloud
arc CLI (local)	✅	✅
CRM dashboard	✅	✅
Workspace VPS persistente	❌	✅
Integración SSH con GitHub	❌	✅
Acceso desde cualquier dispositivo	❌	✅
/continue desde Telegram	❌	✅
Los archivos sobreviven al cierre del portátil	❌	✅

Cómo activarlo

Ve a Billing → Standard Cloud
Suscríbete (consulta el precio actual en el dashboard)
Haz clic en Create Cloud Workspace — el contenedor está listo en menos de 60 segundos
Conecta Claude Code (tu suscripción Claude Pro)
Conecta la clave SSH de GitHub
Clona tu proyecto en /workspace

Tu suscripción Claude Pro/Max es aparte — la aportas tú. Arc OS no cobra por el uso de Claude.

Qué NO es Arc OS

No es un agente autónomo — los workers no corren en segundo plano sin ti. Cada sesión empieza cuando tú la abres.
No es un bot de atención al cliente — los workers hablan contigo (el desarrollador), no con tus usuarios finales.
No es una herramienta de automatización de workflows — Arc OS no se conecta a APIs externas por su cuenta. Los workers te ayudan a escribir código que lo haga.
No es un reemplazo de Claude.ai — Arc OS está construido sobre Claude, con contexto de proyecto y estructura de equipo añadidos.

Primeras preguntas frecuentes

P: ¿Necesito Telegram? No. Telegram es opcional. El CLI bridge es la interfaz principal.

P: ¿Los workers comparten contexto entre sí? Sí — a través de la wiki compartida, los skills y el tracker de issues. No comparten el estado de sesión en vivo, pero leen la misma base de conocimiento.

P: ¿Puedo personalizar los workers? Sí. Worker Studio (en el CRM) te permite editar el system prompt, los skills y el comportamiento de cada worker.

P: ¿Cómo funciona la facturación? Usas tu propia suscripción Claude Pro o Max. Arc OS no añade cargos por el uso de Claude — pagas a Anthropic directamente. Arc OS cobra una cuota de plataforma por el dashboard y las herramientas.

P: ¿Y si quiero un tipo de worker que no está en la lista? Crea un worker personalizado en Worker Studio. Define su rol, sus permisos e inyecta los skills que necesites.

Tus datos y privacidad

Arc OS está diseñado para mantener tus datos bajo tu control.

Exporta tus datos (RGPD Art. 20)

Puedes descargar una exportación JSON completa de todos los datos de tu cuenta en cualquier momento:

Ve a Settings → Security → Download my data
Se genera y descarga un archivo JSON de inmediato

La exportación incluye la información de tu cuenta, proyectos, historial de chat, issues, páginas de wiki, skills y registros de actividad. Limitado a 3 exportaciones cada 24 horas.

Elimina tu cuenta (RGPD Art. 17)

Puedes eliminar tu cuenta de forma permanente en cualquier momento:

Ve a Settings → Security → Delete account
Confirma la eliminación

Esto borra de inmediato y de forma permanente todos tus datos en todas las tablas — proyectos, historial de chat, skills, entradas del vault, registros de actividad y tu fila de cuenta. Esta acción es irreversible.

Lo que no hacemos

No usamos tu código, tus prompts ni las respuestas de la IA para entrenar modelos
No incrustamos trackers publicitarios ni SDKs de analítica
No establecemos cookies HTTP — todo el estado de sesión está en localStorage
No compartimos tus datos con terceros más allá de lo necesario para operar el servicio (CDN de Cloudflare, inferencia de IA de Anthropic, proveedores OAuth)

Para la política completa, consulta la Política de Privacidad.