Vecipp en Telegram: el agente en tu celular Android

(Categoría: Vecipp IA)

¿Qué es y para qué sirve?

Vecipp en Telegram es el mismo agente de la CLI llevado al celular. Le escribes al bot @VecippCLI_Bot y Vecipp trabaja en tu celular Android a través de la app Termux: escribe y corre código, maneja archivos y paquetes, entra a tus servidores, hace webs, juegos y apps Android, y usa el celular mismo. También tiene una terminal dentro de Telegram (la Mini App). Sin un celular conectado, te responde como chat con los modelos de tu plan.

¿En qué te beneficia?

Trabajas desde el celular, sin computador: le pides la tarea por chat y la hace ahí mismo.
Ves lo que hace en vivo, en un solo mensaje que se convierte en la respuesta, sin llenar el chat de mensajes sueltos.
Eliges el idioma de los botones: inglés o español.
Nada se pierde: un texto largo que Telegram parte en varios mensajes se lee como uno; si escribes justo cuando termina, te contesta igual; si se corta la conexión o el bot se reinicia, la tarea sigue.
Lo tuyo es tuyo, también en un grupo: en un grupo cada persona trabaja con su cuenta y su celular, y nada de lo tuyo (tu historial, tus archivos, tu celular, tu cuenta) se muestra a los demás.

¿Cómo funciona?

El idioma: la primera vez que abres el bot eliges English o Español para los botones, los menús y los mensajes del bot. Lo cambias cuando quieras con /language o con el botón 🌐 Language · Idioma de /cmds. Los comandos siguen con su nombre en inglés (/effort, /model…), Vecipp te responde en el idioma en que le escribes, y la terminal (Mini App) está en inglés.
Mientras trabaja, un solo mensaje dice ⌬ Working · 2m 06s, lo que lleva («Read 6 · Edited 3 · 2 commands») y, en el bloque Now, el paso que está haciendo. Debajo tiene los botones Steps ▸ (ver todos los pasos en el mismo mensaje), Stop (detener) y Open terminal.
Al terminar, ese mismo mensaje queda con «✓ Done» arriba, la respuesta y, plegados al final, los pasos y el razonamiento (los abres con un toque). Si hizo un archivo, 📝 Open lo abre en el editor de la terminal y 📎 Send te lo manda al chat.
Si le escribes mientras trabaja, tu mensaje entra en la tarea y el mensaje en vivo baja debajo del tuyo, con el aviso «Your message of 10:43 is in the task».
Si pegas un texto muy largo (un log, un prompt), Telegram lo parte en varios mensajes: Vecipp los junta y lo lee como uno solo («Got your message in 3 parts»). En la terminal, lo que pegas queda como [Pasted text #1 +120 lines].
Si tu celular pierde la conexión, Vecipp sigue trabajando allá y lo que hace llega cuando vuelve. Si el celular se reinicia, sigue con la misma conversación (/new empieza otra).
En un grupo, mencionas al bot (@VecippCLI_Bot tu tarea) y te responde ahí, pegado a tu mensaje; al terminar la tarea vuelve a tu chat privado. /link, /history, /get, /ls, /status, /run, !comando y /open te piden seguir en privado. Los avisos de tus agentes, tus archivos, las actualizaciones del celular y lo que pides desde la terminal llegan siempre a tu chat privado.
Los comandos de todos los días, como en la CLI: /tasks te muestra los agentes y shells que trabajan de fondo (/tasks stop @nombre los detiene y /tasks @agente tu mensaje le escribe a uno); /diff, lo que cambió en el proyecto; /uso, cuánto llevas de tu plan; /cost y /stats, lo que se ha usado; /artifacts, tus artefactos con su enlace; /copy, la última respuesta con el botón de copiar; y /update actualiza el programa del celular. Funcionan igual en la terminal (Mini App).

Videotutorial de Aprendizaje

Video explicativo — próximamente

¿Qué aprenderás en esta guía?

A empezar con el bot, elegir el idioma, conectar tu celular, darle una tarea, seguirla en vivo, detenerla, pedirle un archivo y cambiar el idioma después.

Paso a paso para usar la función

Abre el bot @VecippCLI_Bot en Telegram y toca Start.
Elige el idioma de los botones: English o Español.
Entra a Vecipp: lo más rápido es «Seguir con Telegram (1 toque)»; o entra con Google o tu correo.
Conecta tu celular: responde si ya tienes Termux. Si no, el bot te manda las dos apps oficiales para instalar. Después te da un comando de una línea: cópialo, pégalo en Termux y dale Enter. Cuando diga Linked, el bot te avisa.
Escribe una tarea, por ejemplo: «haz una página para mi panadería con un formulario de pedidos».
Síguela en vivo en el mensaje que se va actualizando. Toca Steps ▸ para ver todos los pasos. Arriba dice qué está haciendo (por ejemplo ⌬ Forging…), su plan si tiene uno (▴ Plan 3/8 y en qué va) y, si el modelo lleva un rato callado, ⚠ waiting for the model. Una búsqueda en internet muestra sus primeros resultados, y al terminar, si cambió archivos, 🔍 View diff te muestra qué cambió.
- Cuando pide permiso para algo que cambia cosas, tienes Yes, No y, según el caso, un Always que dice qué cubre: Always · this server (ese servidor, esta sesión), Always · «destructive command» (ese tipo de riesgo, esta sesión) o Always: npm run * (esa familia de comandos, guardada para el proyecto). Un archivo protegido (como .git) o un comando suelto no ofrecen Always: te pregunta cada vez.
- Si no quieres ese paso, toca ✏️ No, and tell Vecipp what to do y escribe qué debe hacer en su lugar.
- Cuando te hace una pregunta con opciones, también puedes tocar ✏️ Type my own answer y escribir tu respuesta.
- Arriba del mensaje en vivo verás ⚠ ctx 64% cuando la conversación ya ocupa buena parte de la memoria del modelo; desde el 80 % te sugiere /compact.
Si quieres detenerla, toca Stop (o escribe /stop). Si la detienes antes de que conteste, tu mensaje sale de la conversación y el bot te lo devuelve con ✏️ Copy to edit para corregirlo y mandarlo otra vez. Si un comando largo está corriendo, ⤵ Move to the background lo deja trabajando aparte y Vecipp sigue con lo demás. Si quedaron agentes trabajando en segundo plano, el bot te avisa («1 agent is still working») con ⏹ Stop the agent, o uno por uno con ⏹ @nombre. También está el botón en el mensaje en vivo mientras trabajan. Un agente detenido dice was stopped, no «failed».
- En la terminal (Mini App) funciona igual: las tarjetas de permiso y de pregunta traen las mismas opciones para escribir, la línea de trabajo muestra el ⚠ ctx, y al detener la tarea te ofrece ⏹ Stop the agents.
- Si la respuesta trae una tabla, el bot la muestra alineada; si es muy ancha para el celular, una tarjeta por fila. En la Mini App sale como tabla.
Al terminar, lee la respuesta; si hizo un archivo, toca 📎 Send para recibirlo o 📝 Open para abrirlo. Vecipp también te puede mandar una imagen (una captura, un gráfico) que ves en el chat como foto, o un archivo (un PDF, un zip) listo para abrir: pídeselo, por ejemplo «mándame la captura».
Para cambiar el idioma después, escribe /language o toca 🌐 en /cmds.
Para cambiar cómo pide permiso, escribe /mode: va de ✋ Ask (pregunta lo que cambia cosas) a ✎ Edits (edita archivos sin preguntar, pero pregunta antes de los comandos), ⚡ Auto (no pregunta) y 📋 Plan (solo investiga y te propone un plan).
Para usar el modelo gratis más fuerte, escribe /model auto: tu celular prueba los que tienes y se queda con el mejor que conteste. /model auto on hace que cambie solo si el modelo que usas falla.
Para darle una meta que tenga presente en cada tarea, escribe /goal y la meta (por ejemplo /goal terminar la página de la panadería); /goal clear la quita.
Para que repita una tarea hasta que quede (por ejemplo, «corre las pruebas y arregla lo que falle»), escribe /loop y la tarea. Cada vuelta dice 🔁 loop 2/20 arriba de su mensaje; /loop stop (o Stop) la termina.
Para programar una tarea, escribe /schedule in 30m <tarea> o /schedule every 1h <tarea>. Tu celular la corre a esa hora si Termux sigue abierto. /schedule list las muestra y /schedule remove <id> cancela una.
Para dejarle una regla al proyecto, escribe # y la regla (por ejemplo # responde siempre en español): se guarda en el VECIPP.md de tu celular. /memory muestra las reglas vigentes.
Para preguntar algo al margen sin sumarlo a la tarea, usa /btw y la pregunta. /recap te dice en dos frases en qué va la conversación.
Al terminar una tarea puede aparecer un botón 💡 con lo que probablemente quieras pedir después: tócalo para mandarlo tal cual.
Para darle fotos, mándalas con lo que quieres en el texto de la foto. Si la mandas sin texto, el bot dice 📎 Photo ready y la foto va con tu próximo mensaje. Un álbum va completo en una sola tarea (hasta 4 imágenes).
Para darle un archivo (hasta 20 MB), adjúntalo: queda en la carpeta de trabajo de tu celular y va con tu próximo mensaje.
Para hablarle, mándale una nota de voz: el bot muestra 🎙 lo que entendió y lo hace como si lo hubieras escrito. Para eso tu celular necesita una clave de Groq (gratis, en console.groq.com/keys) o de OpenAI: agrégala con /provider. La nota de voz va de tu celular a ese proveedor; no pasa por los servidores de Vecipp.
Para tus proyectos: cada proyecto nuevo queda en su carpeta dentro de ~/vecipp. /cd te los muestra con un botón para entrar a cada uno; /cd ~ vuelve a la carpeta principal y /new también. Si Vecipp cambia de carpeta mientras trabaja, lo dice en el mensaje.
Para organizar tus conversaciones: /rename les pone nombre, /search las busca (con un botón para abrir cada una), /fork copia la actual para probar otro camino sin perderla, y /share te manda la conversación como archivo para reenviarla. /permissions muestra qué puede hacer Vecipp sin preguntarte, /agent cambia su rol (por ejemplo, solo revisar o solo investigar) y /tools lista sus herramientas.
Para trabajar con método: /spec y lo que quieres construir arma requisitos, diseño y tareas, y te pide aprobar cada parte antes de seguir; /simplify limpia el código que cambió en la conversación; /handoff te da una nota para seguir el trabajo en una conversación nueva. /approve te dice cómo te pide permiso Vecipp, /verbose muestra todos los pasos mientras trabaja, /github revisa GitHub en tu celular y /sync enciende o apaga tus conversaciones en ia.vecipp.com/code.
Para mandarle un comentario al equipo de Vecipp (un error o una idea), escribe /feedback y tu mensaje.
Para usar servidores MCP (herramientas de otros programas), ponlos en .vecipp/mcp.json del proyecto en tu celular, como en la CLI, y escribe /mcp reconnect. /mcp dice cuáles conectó y cuántas herramientas trae cada uno. Vecipp te pide permiso antes de usar una.

Errores comunes y cómo solucionarlos

El bot dice que tu celular está desconectado: abre Termux y escribe vecipp-device. Con /wake ves cómo dejarlo siempre encendido.
«Your phone lost the connection» en el mensaje en vivo: tu celular se quedó sin internet o Android cerró Termux. Vecipp sigue cuando vuelve; si tarda más de 10 minutos, la tarea se cierra y puedes volver a pedirla.
«Your phone restarted and this task did not finish»: Termux se cerró en medio de la tarea. La conversación se guarda: escribe «sigue» o vuelve a pedirla.
Los comandos siguen en inglés aunque elegí Español: es así a propósito; solo cambian los botones y los mensajes del bot.
Detuve la tarea pero los agentes siguen trabajando: detener la tarea no detiene los agentes de fondo, como en la CLI. Toca ⏹ Stop the agents en el aviso, o escribe /tasks stop all.
No me sale «Always» al aprobar un comando: es a propósito. Un comando sin una familia que nombrar (por ejemplo cd a && make) dejaría pasar todos los comandos de la sesión; apruébalo cada vez o usa el modo Auto (/auto).
Un botón «📎 Send» viejo no manda nada: es de antes de que el bot se reiniciara; pide el archivo con /get ruta/del/archivo.
En un grupo el bot me dice que siga en privado: es a propósito. Ese comando muestra algo tuyo (tu historial, tus archivos, tu celular o el código para enlazarlo) y en el grupo lo leerían todos. Tócale el botón y hazlo en tu chat privado con el bot.
Una tarea programada no corrió: tu celular la corre solo si Termux está abierto a esa hora. Revisa con /schedule list y usa /wake para dejarlo siempre encendido.
/mcp dice «failed» junto a un servidor: el programa de ese servidor no está instalado en Termux o falló al arrancar. Instálalo (por ejemplo con npm i -g o pkg install) y escribe /mcp reconnect.
«Could not understand the voice note» y te pide una clave: tu celular no tiene una clave de Groq ni de OpenAI. Agrégala con el botón (o /provider) y vuelve a mandar la nota.
«Your phone did not answer the voice note»: el programa de tu celular es viejo. Escribe /update y mándala otra vez.
«That file is … MB»: Telegram solo les entrega a los bots archivos de hasta 20 MB. Copia el archivo a la carpeta Download de tu celular y dile a Vecipp que está en ~/storage/downloads, o mándalo comprimido o por partes.
«Unknown command»: ese comando no existe (o tiene un error al escribirlo). /cmds muestra todos los que hay.

Qué no hace todavía

No funciona en iPhone: Termux existe solo para Android. En un iPhone puedes usar el bot como chat.
Archivos de más de 50 MB no llegan por el chat (es el límite de los bots de Telegram); quedan en tu celular. Y los que tú le mandas, hasta 20 MB.
Las notas de voz necesitan tu clave de Groq u OpenAI: todavía no se entienden con los modelos de tu plan de Vecipp.
La terminal (Mini App) no recibe fotos ni notas de voz: mándalas en el chat del bot.
El idioma es solo del bot: la terminal (Mini App) y la CLI siguen en inglés.
No hay un botón «Deshacer» en la respuesta: usa /rewind para volver los archivos a antes de una tarea.
El bot no se comunica todavía con tus otras sesiones de Vecipp (la CLI o el escritorio).
El resumen automático al volver (el que la CLI escribe cuando regresas después de un rato) todavía no está: pídelo con /recap.
Las tareas programadas no corren con el celular apagado o con Termux cerrado.