Tengo más proyectos que tiempo delante del portátil.

I have more projects than time in front of my laptop.

Con varios proyectos activos, cada tarea empezaba igual: abrir el portátil, buscar la carpeta, arrancar el agente y esperar delante de la pantalla. Quería lanzarla desde el móvil, seguirla mientras hacía otra cosa y revisar el resultado cuando pudiera, con cada proyecto en su propio hilo.

With several projects going at once, every task started the same way: open the laptop, find the folder, start the agent and wait in front of the screen. I wanted to launch it from my phone, follow it while doing something else and review the result when I could, with each project in its own thread.

Cómo funciona

How it works

1. Un tema por proyecto. Creas uno con /new, traes un repo de GitHub con /clone o importas una carpeta que ya tengas con /import. Cada proyecto tiene su carpeta, su sesión y su historial.
2. Escribes la tarea. Un mensaje normal en el tema es una tarea para ese proyecto. Si hay otra en marcha, se pone en cola y te dice en qué posición.
3. El agente trabaja y te va contando. El mensaje se actualiza en directo mientras trabaja y, al terminar, tienes su respuesta con lo que ha costado y las herramientas que ha usado.
4. Revisas y despliegas. /review revisa los cambios o un PR, /github crea el repo y lo sube, y /vercel deploy despliega en producción tras pedirte confirmación (o /vercel preview para una URL de prueba).

1. One topic per project. Create one with /new, bring a GitHub repo with /clone or import a folder you already have with /import. Each project has its own folder, session and history.
2. Write the task. A plain message in the topic is a task for that project. If another one is running, it's queued and you're told its position.
3. The agent works and keeps you posted. The message updates live while it works and, when it's done, you get its reply with the cost and the tools it used.
4. Review and deploy. /review reviews the changes or a PR, /github creates the repo and pushes it, and /vercel deploy deploys to production after asking for confirmation (or /vercel preview for a test URL).

Qué puedes hacer

What you can do

¿Y las apps oficiales?

What about the official apps?

Hoy puedes lanzar tareas de código desde el móvil con las apps oficiales, y para mucha gente es suficiente. Esta es mi forma de elegir:

Today you can launch coding tasks from your phone with the official apps, and for many people that's enough. This is how I'd choose:

Lo que debes saber antes de instalarlo.

What you should know before installing it.

Instálalo en tres pasos

Install it in three steps

1. Prepara Telegram.Set up Telegram. Crea un bot con @BotFather, un grupo con los temas activados y un tema para los proyectos nuevos, y añade el bot como administrador. Create a bot with @BotFather, a group with topics enabled and a topic for new projects, and add the bot as an admin.
2. Instala y arranca.Install and start. Necesitas Node 20 y al menos un agente instalado y con la sesión iniciada (Claude Code, Codex u OpenCode). You need Node 20 and at least one agent installed and logged in (Claude Code, Codex or OpenCode).

   git clone https://github.com/niuxito/telegram-control.git
   cd telegram-control && npm install && npm run build
   cp .env.example .env   # pon solo BOT_TOKEN# set only BOT_TOKEN
   npm start

3. Empareja.Pair. El bot muestra un código en la terminal. Envía /setup <código> en el tema de proyectos nuevos y él mismo guarda los datos y arranca. Con npm run install-service queda funcionando siempre. The bot prints a code in the terminal. Send /setup <code> in the new-projects topic and it saves the details and starts. npm run install-service keeps it running.

Funciona en cualquier máquina con Node; una Raspberry Pi es un buen servidor siempre encendido, pero no es obligatoria.

Runs on any machine with Node; a Raspberry Pi makes a good always-on host, but it isn't required.