Ayuda y preguntas frecuentes

Todo lo necesario para empezar con TermBuddy, más las respuestas a las preguntas que más nos hacen.

Inicio rápido

1. Añade un servidor

Abre TermBuddy, toca «Añadir servidor» e introduce la dirección, el puerto SSH y el usuario, con contraseña o clave SSH. No hace falta nada más: TermBuddy se conecta por SSH e instala automáticamente su pequeño asistente en el servidor.

2. Crea un Buddy

Un Buddy es una sesión persistente en tu servidor que se muestra como un chat. Crea un Buddy de terminal para lanzar comandos como si enviaras mensajes, o un Buddy de IA (Claude Code, Codex o Gemini) que trabaja en el directorio de proyecto que elijas.

3. Conversa

Envía comandos o instrucciones; la salida vuelve como respuestas. Cierra la app cuando quieras: las tareas largas siguen en el servidor y recibes una notificación al terminar.

Preguntas frecuentes

¿Qué es exactamente TermBuddy?

TermBuddy convierte servidores remotos en conversaciones de chat en tu iPhone y tu Mac. Las sesiones de terminal y los agentes de IA (Claude Code, Codex, Gemini CLI) se vuelven «buddies» a los que escribes. Las sesiones persisten en el servidor, así que el trabajo continúa aunque el móvil esté en el bolsillo.

¿Es seguro? ¿Qué puertos tengo que abrir?

Solo SSH (normalmente el puerto 22), el mismo que ya usas. El asistente que TermBuddy instala en tu servidor escucha únicamente en 127.0.0.1 y nunca queda expuesto a internet; todo el tráfico va por tu conexión SSH. Las credenciales se guardan en el Llavero del sistema de tu dispositivo y nada pasa por servidores de terceros.

¿Qué necesito en el servidor?

Un servidor Linux o macOS al que puedas entrar por SSH. Sin configuración manual: TermBuddy sube y configura su asistente por ti. Para los Buddies de IA necesitas además la CLI de IA (por ejemplo Claude Code) instalada y con sesión iniciada en el servidor; la página del servidor incluye un instalador guiado para eso.

¿Qué asistentes de IA son compatibles?

Claude Code, OpenAI Codex CLI y Google Gemini CLI. La IA se ejecuta en tu servidor, en el directorio de trabajo que elijas, con su propio inicio de sesión y facturación (por ejemplo tu cuenta de Anthropic). TermBuddy es el mando a distancia: planes, tareas, preguntas y resultados llegan como mensajes de chat.

¿Los comandos se detienen si cierro la app?

No. Las sesiones viven en el servidor. Cierra la app, quédate sin cobertura, cambia de dispositivo: al volver, el historial completo sigue ahí. Las notificaciones push te avisan cuando una tarea larga acaba o falla.

¿Qué es la biblioteca de memoria (Experience)?

Una base de conocimiento personal con preferencias, notas de proyecto y lecciones aprendidas, sincronizada automáticamente desde tu Mac a todos los servidores para que cualquier Buddy de IA pueda usarla. Importa tu memoria de Claude con un toque y usa «Categorizar» para que una IA lo ordene todo en carpetas temáticas.

¿Qué son las Skills?

Paquetes de instrucciones reutilizables (revisión de código, depuración sistemática, TDD, análisis de datos, escritura científica y más) que enseñan a los Buddies de IA a hacer bien una tarea. Actívalas en la pestaña Skills de la app de Mac: se despliegan solas en todos tus servidores y la IA elige la adecuada cuando tu petición encaja.

Mi buddy se queda en «Procesando…», ¿qué hago?

Abre la pestaña Servidores y revisa el estado del servidor. Reiniciar el asistente de TermBuddy desde ahí resuelve la mayoría de los casos; si un punto rojo indica que hay actualización, actualiza el asistente. Comprueba también en la página del servidor que la CLI de IA está instalada y con sesión iniciada.

No consigo conectar con mi servidor.

Primero comprueba que un SSH normal funciona desde otro terminal con el mismo host, puerto, usuario y credenciales. Si SSH va pero TermBuddy no, revisa el estado en la pestaña Servidores y el registro del servidor en ~/.termbuddy/termbuddy.log.

¿Cómo funcionan las actualizaciones?

Las apps se actualizan por la App Store. El asistente del servidor se actualiza desde la propia app: un punto rojo en la pestaña Servidores indica que hay una versión nueva y un toque la instala por SSH.

¿Qué datos recopiláis?

Tu dispositivo habla directamente con tu servidor, sin intermediarios. Nunca vemos tus credenciales, comandos, salidas ni archivos. Consulta la política de privacidad para el detalle completo.

¿Dónde consigo soporte?

Escribe a atlai@atlai.co.uk o usa «Enviar comentarios» dentro de la app. Los informes de error con el registro del servidor (~/.termbuddy/termbuddy.log) son especialmente útiles.