⚡ WarpClip: Puente Local para Gemini 4 Argon (Web Pro)

⚡ WarpClip — Puente Cero-Clics para Gemini 4 Argon

Resumen de la Herramienta

WarpClip es una herramienta CLI en Python + Extensión de Chrome (MV3) y Userscript que conecta tu entorno de desarrollo local en Linux directamente con Google Gemini 4 Argon en la web (gemini.google.com), permitiéndote generar, refactorizar y aplicar código o notas de forma atómica sin pagar tokens de API.

• 💻 Repositorio GitHub: github.com/Alecwce/warpclip
• 📂 Ruta Local: /home/alexwce/Documentos/nada3/warpclip

---

🎯 ¿Qué problema resuelve?

1. Google AI Studio (API): Asigna cuota 0 / 0 RPM para Gemini 4 Argon en la capa gratuita salvo que pagues por token.
2. Suscripción Google AI Pro (Web): Da acceso completo e ilimitado a Gemini 4 Argon en gemini.google.com.
3. WarpClip: Elimina la fricción de copiar y pegar archivo por archivo, automatizando el empaquetado del proyecto, el envío a la pestaña del navegador y la aplicación segura de cambios con respaldos instantáneos.

---

🏗️ Arquitectura de Doble Vía (WebSocket Bridge + Portapapeles)

flowchart LR
    subgraph Local["🐧 Entorno Local Linux (CLI + Daemon)"]
        CLI["⚡ warpclip send / pack\n(Bundler + Git Diff + SecretShield)"]
        Daemon["🔌 warpclip daemon\n(HTTP + WebSocket 127.0.0.1:8765)"]
        Patcher["🛠️ ResponseParser & FilePatcher\n(FILE / PATCH / DELETE)"]
        Backup[("🛡️ .warpclip/backups/\nSnapshots Inmutables")]
    end

    subgraph Browser["🌐 Navegador (gemini.google.com)"]
        Ext["🧩 Extensión Chrome MV3\no Userscript"]
        Argon["🧠 Gemini 4 Argon\n(Modo Chat & Modo Tarea)"]
    end

    CLI -->|POST /send| Daemon
    Daemon -->|WS: INJECT_PROMPT| Ext
    Ext -->|Inyecta y envía| Argon
    Argon -->|Genera respuesta| Ext
    Ext -->|WS: RESPONSE_COMPLETED| Daemon
    Daemon -->|Entrega payload| Patcher
    Patcher -->|1. Crea respaldo| Backup
    Patcher -->|2. Escribe en disco| Local

---

🚀 Guía Rápida de Comandos

Comando	Descripción	Ejemplo de Uso
warpclip send	Flujo Cero-Clics: Empaqueta archivos, los inyecta en Gemini Web, espera la respuesta de Argon y aplica los cambios en disco.	warpclip send src/ -t -p "Optimiza las consultas SQL" -y
warpclip serve	Inicia o detiene el demonio local WebSocket en el puerto 8765.	warpclip serve -d / warpclip serve --stop
warpclip pack	Empaqueta archivos, árbol de directorios y git diff en el portapapeles del sistema (xclip / wl-copy).	warpclip pack main.py -p "Agrega manejo de errores"
warpclip apply	Lee la respuesta copiada de Argon desde el portapapeles, muestra el diff y actualiza los archivos.	warpclip apply --yes
warpclip watch	Modo centinela: vigila el portapapeles y aplica cambios automáticamente al pulsar “Copiar” en Gemini Web.	warpclip watch --auto-apply
warpclip diff	Previsualiza los cambios propuestos en consola sin modificar el disco.	warpclip diff
warpclip rollback	Deshace instantáneamente la última aplicación restaurando el snapshot previo.	warpclip rollback (o warpclip undo)
warpclip history	Muestra el historial de snapshots creados con fecha y archivos tocados.	warpclip history
warpclip status	Diagnóstico del workspace, backend de portapapeles, estado de Git y del daemon.	warpclip status

---

📋 Protocolo de Salida de Argon

WarpClip instruye automáticamente al modelo para responder utilizando tres bloques estandarizados:

1. Edición Quirúrgica (### PATCH:) — Ideal para archivos grandes:

   ### PATCH: src/auth.py
   <<<<<<< SEARCH
   def verify(token):
       return True
   =======
   def verify(token: str) -> bool:
       return bool(token and len(token) > 10)
   >>>>>>> REPLACE

2. Creación o Reemplazo Completo (### FILE:):

   ### FILE: src/config.py
   ```python
   PORT = 8765

3. Eliminación Segura (### DELETE:):

   ### DELETE: src/old_module.py

---

🛡️ Seguridad Incorporada

• Jail Containment (PathValidator): Bloquea cualquier intento de escribir fuera de la raíz del proyecto (../../etc/passwd).
• Secret Shield: Excluye automáticamente .env*, claves privadas .pem, id_rsa y .git/ al empaquetar el contexto.
• Zero Data Loss (SnapshotManager): Antes de tocar cualquier archivo, guarda una copia exacta en .warpclip/backups/ para permitir warpclip rollback en milisegundos.

---

🔗 Relacionado en la Bóveda

• Ficha del proyecto (Proyectos Privados): estado, stack y enlaces del repositorio.
• Plan Maestro Google Vids CLI: Automatización de herramientas web de Google.
• rea-reverse-engineering: Inspección de aplicaciones y runtime web.
• obsidian-git-facil: Sincronización automática de las notas generadas con GitHub.