# OpenAdmiral

> Dirige tu flota de agentes de IA desde un único puente de mando. OpenAdmiral es una app para macOS y un plugin de Claude Code, gratis y de código abierto, para trabajar con muchas sesiones de Claude Code a la vez: ve todos tus agentes de un vistazo, recibe un aviso cuando uno te necesita, deja que se deleguen trabajo entre ellos, programa prompts, mantenlos trabajando con la tapa cerrada y reúne todos los informes que generan.

Ya no escribes cada línea tú. Deja también de vigilar cada terminal. OpenAdmiral es el centro de mando de tus sesiones de Claude Code: míralas todas de un vistazo, intervén solo cuando te necesiten y deja que trabajen juntas.

- Web: https://openadmiral.com/es/
- Código fuente (MIT): https://github.com/OpenAdmiral/openadmiral
- Descargar para macOS: https://openadmiral.com/download
- Estado: Alfa temprana. macOS 13 o posterior · Apple Silicon e Intel · Licencia MIT.
- This page in English: https://openadmiral.com/index.md

## El problema, resuelto

Más agentes deberían significar más trabajo hecho. OpenAdmiral te saca del cuello de botella.

- **No ves tu propia flota.** Seis terminales, seis pestañas, seis historiales. → Todas las sesiones en un mapa: quién trabaja, quién ha terminado y quién está atascado.
- **El agente que te necesita espera en silencio.** Te pidió un permiso hace veinte minutos, en una ventana que no estabas mirando. → Un aviso en cuanto se detiene, y un clic para responder.
- **Tus agentes no pueden hablar entre ellos.** El frontend necesita un endpoint del backend, y el mensajero acabas siendo tú. → Los agentes se pasan el trabajo y te informan solos.
- **El trabajo se para cuando paras tú.** Te levantas de la mesa y nada avanza. → Deja preparado el siguiente paso: se ejecuta cuando el agente queda libre, cuando llega otro trabajo o a las 8 de la mañana. Cierra la tapa y siguen trabajando.
- **Los resultados quedan enterrados.** El informe, el diagrama o el plan que pediste se pierden bajo miles de líneas. → Cada informe, diagrama y página se guarda, se ve bien y conserva sus versiones.

## Cómo funciona

### Todo de un vistazo: Toda tu flota, en un mapa.

Cada sesión de Claude Code de cada proyecto en una sola ventana: en qué está trabajando, cuánto le falta, cuánto contexto le queda y cuánto cuesta. Las sesiones se agrupan por repositorio y las que te necesitan suben arriba.

- Estado en directo, rama y cambios sin confirmar
- Contexto restante y coste de cada sesión
- Quién le pasa trabajo a quién, dibujado como enlaces

Atajo en la app: ⌘E

### Intervén solo cuando importa: Te avisa justo cuando te necesita.

Cuando un agente se detiene a esperar un permiso o una decisión, lo sabes al momento, no veinte minutos después en una pestaña que no mirabas. Haz clic en la notificación y ya estás ahí.

- Notificaciones nativas de macOS
- Los agentes que te necesitan suben arriba
- Recorre uno a uno a todos los que te esperan

Atajo en la app: ⌘⌥⇧↓

### Toma el timón: El verdadero Claude Code. Dentro de la app.

Abre cualquier agente y estás en su propia terminal, dentro de OpenAdmiral. No es un envoltorio ni una imitación: es el mismo Claude Code con tus plugins, hooks, skills, servidores MCP y atajos. Aprueba, responde y sigue.

- Conéctate al instante a sesiones en segundo plano
- Cada novedad de Claude Code desde el día que sale
- ¿Prefieres tu propia terminal? También funciona

Atajo en la app: ⌃1

### Agentes que trabajan juntos: Deja de hacer de mensajero.

Un agente puede pasarle una tarea a otro con un encargo claro, y ese agente informa según avanza: aceptado, en curso, bloqueado, hecho. ¿El checkout necesita un endpoint? Se lo pide al agente de la API. Tú ves fluir el trabajo en vez de cargar con él.

- Delegaciones con estado, notas y resultados
- Ve qué está bloqueado y por quién
- Quien delegó se entera en cuanto llega el trabajo

Atajo en la app: ⌘D

### El trabajo no se para: Aunque no estés mirando, tus agentes siguen trabajando.

Deja preparado lo siguiente que debe hacer cada agente. Un prompt se ejecuta cuando el agente queda libre, cuando llega el trabajo de otro agente o a una hora programada, despertando una sesión cerrada si hace falta.

- Pon en cola prompts y comandos
- Ejecuta algo en cuanto se completa una delegación
- Programaciones recurrentes: de lunes a viernes a las 08:00

Atajo en la app: ⌘J

### Cierra la tapa: Cierra la tapa. La flota sigue navegando.

Un Mac se duerme en cuanto cierras la tapa, y tus agentes se paran con él. Activa Underway y se queda despierto mientras tengan trabajo; después se duerme como siempre. Antes de recoger, arriba a la derecha tienes la respuesta: Safe to close the lid, puedes cerrar la tapa.

- Se detiene solo: poca batería, demasiado calor o un límite de tiempo
- Los agentes que paró una caída de la conexión siguen en cuanto vuelve la red
- Tu iPhone como red de respaldo, por cable o compartiendo internet

### Lee el historial: Vuelve atrás en el tiempo en cualquier conversación.

La conversación completa de cada sesión, cada prompt, cada llamada a herramienta y cada respuesta, legible y con búsqueda, incluso en las sesiones a las que nunca te conectaste. Ponte al día en segundos de lo que hizo un agente mientras no estabas.

- Índice turno a turno con las herramientas usadas
- Busca en prompts y respuestas
- Funciona con sesiones que corren en cualquier sitio

Atajo en la app: ⌃2

### Todos los resultados, en un sitio: Revisa lo que crean tus agentes, no un montón de texto.

Los informes, planes, diagramas y páginas que generan tus agentes se guardan junto al trabajo que los produjo, con todas sus versiones. Se acabó buscar el resumen enterrado bajo diez mil líneas de salida.

- Informes, maquetas de UI, diagramas y páginas HTML en vivo
- Todas las versiones, con notas
- Una galería para toda la flota

Atajo en la app: ⌘G

### Sin sorpresas en la factura: Vigila los costes al detalle.

Lo que cuesta cada proyecto hoy y este mes, con qué modelos funciona y cuánto te queda de tu plan antes del límite, siempre a la vista.

- Gasto por proyecto y por modelo
- Previsión a final de mes
- Límites del plan de 5 horas y semanal, con la hora en que se reinician

Atajo en la app: ⌘U

## La potencia de la terminal, la comodidad del escritorio

Claude Code en la terminal es la forma más potente de crear con Claude. Pero una terminal muestra una sesión cada vez, en texto plano y solo mientras la miras. OpenAdmiral añade lo que una app de escritorio hace bien, sin quitarte nada de lo que la terminal hace mejor.

Lo que conservas (la terminal):

- El verdadero Claude Code, con cada novedad desde el día que sale
- Tus plugins, hooks, skills, servidores MCP y ajustes
- Tu terminal, tu editor y tus atajos
- Sesiones que siguen en segundo plano, con o sin la app abierta

Lo que ganas (la app):

- Todas las sesiones de un vistazo, y primero las que te necesitan
- Un aviso en cuanto un agente te está esperando
- Informes, planes, diagramas y páginas, listos para ver
- Cada conversación legible y con búsqueda
- Agentes que se pasan trabajo, colas y programaciones
- Agentes que siguen trabajando con la tapa cerrada
- Lo que cuesta todo y cuánto te queda de tu plan

## Un día con OpenAdmiral

- **9:00** Esta noche, un prompt programado ejecutó la batería de pruebas end-to-end y un agente ya ha arreglado lo que falló. Dos agentes están trabajando, uno ha terminado y te ha dejado un informe, y otro te hace una pregunta.
- **9:05** Respondes a la pregunta. Le pides al agente del checkout un rediseño en una sola página; ve que necesita un endpoint nuevo y se lo encarga al agente de la API.
- **9:10** Dejas preparado su siguiente paso para que arranque en cuanto llegue el endpoint, y te vas a una reunión.
- **11:00** El endpoint está integrado, el checkout va por la mitad y el informe de progreso te espera en Artifacts. No has copiado ni una línea de una terminal a otra.
- **18:00** Dos agentes siguen trabajando. Arriba a la derecha pone Safe to close the lid, así que cierras la tapa y te vas a casa. Terminan por el camino.

## Construido sobre lo que ya usas

- **Tu Claude Code, sin cambios.** Sin agentes nuevos, sin envoltorios, sin otros modelos. OpenAdmiral es un plugin de Claude Code: no parchea nada ni lee la pantalla. Quítalo y todo queda exactamente como estaba.
- **100% local.** Tu código y tus sesiones nunca salen de tu Mac: la app y tus sesiones se comunican mediante archivos en tu carpeta de Claude. Sin cuenta. Un ping diario anónimo cuenta las instalaciones, y puedes desactivarlo.
- **Código abierto.** Licencia MIT. Léelo, cámbialo, hazlo tuyo. Las ideas, issues y pull requests son bienvenidas.

El plugin funciona dentro de cada sesión de Claude Code y publica su estado como archivos JSON en `~/.claude/openadmiral/`. La app vigila esos archivos, integra las terminales de las sesiones y escribe peticiones de vuelta (prompts en cola, traspasos, cambios de nombre). Los agentes obtienen las herramientas `delegate`, `delegation_update`, `status` y `show`.

## Instalación

1. **Añade el plugin.** En cualquier sesión de Claude Code:

   ```
   /plugin marketplace add OpenAdmiral/openadmiral
   /plugin install openadmiral@openadmiral
   ```

   Ejecuta /reload-plugins en las sesiones que ya estaban abiertas.

   En la extensión de VS Code, donde /plugin no está disponible: vscode://anthropic.claude-code/install-plugin?plugin=openadmiral&marketplace=OpenAdmiral/openadmiral

   O escribe /plugins, añade OpenAdmiral/openadmiral en la pestaña Marketplaces e instala openadmiral desde la pestaña Plugins.

2. **Instala la app.** Descarga el último .dmg (macOS 13 o posterior, Apple Silicon e Intel), ábrelo y arrastra OpenAdmiral a Aplicaciones.

   Firmada y notarizada por Apple: se abre como cualquier otra app.

3. **Abre OpenAdmiral.** Cada sesión con el plugin aparece sola. Eso es todo.

Descarga: https://openadmiral.com/download

O con Homebrew:

```sh
brew install --cask openadmiral/tap/openadmiral
```

Compilar desde el código fuente (necesitas Rust, Node 20+ y pnpm):

```sh
git clone https://github.com/OpenAdmiral/openadmiral.git
cd openadmiral/app && pnpm install && scripts/install.sh
```

## Preguntas frecuentes

### ¿Qué es OpenAdmiral?

Una app para macOS y un plugin de Claude Code, gratis y de código abierto. El plugin funciona dentro de cada sesión de Claude Code y publica su estado; la app muestra todas tus sesiones en una ventana, te avisa cuando una te necesita, integra sus terminales y permite que los agentes se deleguen trabajo, pongan prompts en cola y publiquen informes.

### ¿Sustituye a Claude Code?

No. Tus sesiones son el verdadero Claude Code, con todos sus comandos, plugins, hooks, skills y servidores MCP. OpenAdmiral se conecta al sistema de extensiones de Claude Code y añade encima un puente de mando de escritorio.

### ¿Mi código o mis datos salen de mi Mac?

No. Tu código, tus prompts y tus sesiones se quedan en tu Mac: la app y tus sesiones se comunican mediante archivos JSON en ~/.claude/openadmiral, y no hay cuenta. La app solo envía un ping anónimo al día (un identificador aleatorio de instalación, la versión de la app y tu versión de macOS) para contar instalaciones, y puedes desactivarlo. Más en openadmiral.com/es/privacy.

### ¿Los agentes siguen trabajando con la app cerrada?

Sí. Las sesiones corren en segundo plano con o sin la app abierta, y los prompts programados pueden despertar una sesión cerrada cuando les toca.

### ¿Los agentes siguen trabajando con la tapa cerrada?

Sí, con Underway activado: el Mac se queda despierto mientras tus agentes tengan trabajo y después se duerme como siempre. Se detiene solo por debajo de un mínimo de batería (20 % por defecto), si el Mac se calienta demasiado o tras un límite de tiempo (8 h por defecto), y si OpenAdmiral se cierra, el Mac vuelve a dormirse con normalidad en menos de 90 segundos. Mantener un Mac despierto con la tapa cerrada necesita un pequeño asistente del sistema: macOS te pide permitirlo una vez, en Ajustes del Sistema → Ítems de inicio, y desde ahí puedes quitarlo.

### ¿Puedo seguir usando mi propia terminal?

Sí. Sigue trabajando en tu terminal o directamente dentro de OpenAdmiral. Las dos ven las mismas sesiones.

### ¿Qué necesito para usarlo?

Un Mac con macOS 13 Ventura o posterior (Apple Silicon o Intel) y Claude Code. OpenAdmiral es gratis y con licencia MIT.

### ¿Puedo instalarlo con Homebrew?

Sí: brew install --cask openadmiral/tap/openadmiral. Instala la misma app firmada y notarizada que la descarga, y la app se sigue actualizando sola.

### ¿Cómo consigo ayuda o informo de un problema de seguridad?

Escribe a support@openadmiral.com o abre una incidencia en GitHub. ¿Has encontrado una vulnerabilidad? Escribe a security@openadmiral.com en lugar de abrir una incidencia pública (ver openadmiral.com/.well-known/security.txt).

### ¿OpenAdmiral es de Anthropic?

No. OpenAdmiral es un proyecto de código abierto independiente, sin relación con Anthropic ni respaldo suyo. Claude y Claude Code son marcas de Anthropic.

### ¿Es estable?

Es una alfa temprana: habrá detalles por pulir y actualizaciones frecuentes, que la app instala sola. Las versiones están firmadas y notarizadas por Apple.

---

OpenAdmiral es un proyecto de código abierto independiente, sin relación con Anthropic ni respaldo suyo. Claude y Claude Code son marcas de Anthropic.
