Repolode
Samin100

Samin100/codex-ios-assistant

CLI que permite a Codex en una Mac controlar y consultar un iPhone mediante iMessage y un atajo de iOS.

Estrellas
271
Forks
35
Issues abiertos
1
Último commit
hace 2 meses

¿Qué es?

Codex iOS Assistant permite que Codex, ejecutándose en una Mac, envíe comandos a un iPhone. La CLI `iphone` envía comandos privados por iMessage, un atajo de iOS ejecuta en el teléfono la acción solicitada y el resultado se devuelve a la Mac mediante un endpoint HTTPS autenticado, expuesto a través de un Cloudflare Tunnel.

Entre las acciones compatibles están leer el texto visible en pantalla o guardar una captura, leer y reemplazar el portapapeles, consultar y gestionar alarmas, abrir aplicaciones comunes de iOS, activar o desactivar temporizadores, la linterna y Low Power Mode, hacer llamadas y buscar en Contactos de la Mac o en su base de datos de Mensajes. La redacción de mensajes solo abre un borrador para revisarlo; la CLI no envía mensajes comunes, compra artículos, instala aplicaciones ni solicita viajes.

La instalación requiere una Mac con macOS 14 o posterior, un dominio gestionado en Cloudflare y la sincronización de Atajos mediante iCloud. El activador de automatización del atajo debe crearse manualmente en la app Atajos del iPhone.

Funciones clave

  • 01Lee el texto visible en la pantalla del iPhone o guarda una captura.
  • 02Lee y reemplaza el contenido del portapapeles del iPhone.
  • 03Consulta, crea y desactiva alarmas.
  • 04Abre aplicaciones comunes de iOS y controla temporizadores, la linterna y Low Power Mode.
  • 05Busca en Contactos de la Mac y lee su base de datos de Mensajes.
  • 06Devuelve las respuestas del teléfono a la Mac a través de un Cloudflare Tunnel autenticado.

Casos de uso

  • Permitir que Codex compruebe qué aparece en la pantalla del iPhone mientras se depura un flujo móvil.
  • Transferir texto entre los portapapeles de la Mac y el iPhone durante una tarea.
  • Pedirle a Codex que configure o revise alarmas y temporizadores de forma remota.
  • Consultar contactos de la Mac o mensajes recientes desde una sesión de Codex.

Inicio rápido

  1. 1

    Clona el repositorio

    git clone https://github.com/samin100/codex-ios-assistant.git
  2. 2

    Entra en la carpeta del proyecto

    cd codex-ios-assistant
  3. 3

    Instala cloudflared e imsg con Homebrew

    brew install cloudflared steipete/tap/imsg
  4. 4

    Ejecuta el script de instalación

    ./scripts/install

Antes de usarlo

  • Necesitas un Mac con macOS 14 o posterior.
  • Necesitas un dominio gestionado en Cloudflare para el túnel HTTPS.
  • Debes crear manualmente la automatización de Atajos del iPhone y tener activada la sincronización de Atajos con iCloud.
  • El flujo de trabajo Remote requiere las aplicaciones de escritorio y móvil de ChatGPT.

Temas

Preguntas frecuentes

¿Qué es codex-ios-assistant?
CLI que permite a Codex en una Mac controlar y consultar un iPhone mediante iMessage y un atajo de iOS. Codex iOS Assistant permite que Codex, ejecutándose en una Mac, envíe comandos a un iPhone. La CLI `iphone` envía comandos privados por iMessage, un atajo de iOS ejecuta en el teléfono la acción solicitada y el resultado se devuelve a la Mac mediante un endpoint HTTPS autenticado, expuesto a través de un Cloudflare Tunnel.
¿codex-ios-assistant es gratuito? ¿Qué licencia tiene?
codex-ios-assistant es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿codex-ios-assistant sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de codex-ios-assistant fue el 7 ago 2026.
¿Para qué puedo usar codex-ios-assistant?
Permitir que Codex compruebe qué aparece en la pantalla del iPhone mientras se depura un flujo móvil. Transferir texto entre los portapapeles de la Mac y el iPhone durante una tarea. Pedirle a Codex que configure o revise alarmas y temporizadores de forma remota. Consultar contactos de la Mac o mensajes recientes desde una sesión de Codex.
¿Cómo se instala codex-ios-assistant?
Clona el repositorio: git clone https://github.com/samin100/codex-ios-assistant.git Entra en la carpeta del proyecto: cd codex-ios-assistant Instala cloudflared e imsg con Homebrew: brew install cloudflared steipete/tap/imsg Ejecuta el script de instalación: ./scripts/install
¿Dónde consigo codex-ios-assistant?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Samin100/codex-ios-assistant

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados