Saltar al contenido
Inicio
Docs/Terminal Linux

Terminal Linux

El terminal de PocketCode te da un shell de verdad en el móvil, con tus proyectos como carpeta de inicio, pestañas, vista dividida y un panel de 20 herramientas. Empieza como ash de BusyBox sobre un pseudo-terminal nativo; prepara el Linux opcional de la app y abre Alpine, con apk para instalar lo que necesites. El trabajo remoto (hosts SSH, SFTP, redirección de puertos) tiene su propia página.

The Terminal start screen on a tablet: a Local Shell card and the Quick Connect and Browse Hosts shortcuts
La pantalla de inicio del Terminal: un shell local, más Conexión Rápida y Explorar Hosts para SSH remoto.

Qué es y cómo se abre

El Terminal no es una de las cinco páginas del pager: se abre sobre la app como una capa a pantalla completa. Hay tres formas de entrar.

  1. 1Toca el botón Herramientas de la barra de navegación y elige Terminal en la hoja Herramientas de desarrollo.
  2. 2Abre la paleta de comandos y ejecuta Abrir terminal («Abre una sesión de terminal»).
  3. 3En Home, toca la acción rápida Terminal. Es una de las tres acciones rápidas que se muestran por defecto.
Las sesiones siguen funcionando cuando sales del Terminal. Vuelve y retómalas desde los chips que hay sobre la pantalla de inicio. Atrás dentro de una sesión te lleva a la pantalla de inicio sin cerrarla.
El botón Run del editor no abre el Terminal, el explorador de archivos no tiene «abrir terminal aquí» y el Terminal no define atajos de teclado propios.

Mapa de pantallas

El Terminal son tres pantallas (inicio, Terminal y SSH) que comparten una barra de pestañas, un panel de herramientas y las mismas hojas. Esta página cubre la pantalla de inicio, la pantalla Terminal local y todas las herramientas del shell local; la pantalla SSH está en su propia página.

PantallaCómo llegasQué puedes hacer
Pantalla de inicioEs lo primero que se abre. Atrás desde una sesión vuelve aquí.Elige Shell local, Conexión Rápida o Explorar Hosts. Retoma una sesión en marcha desde los chips de arriba.
Terminal (shell local)Shell local en la pantalla de inicio, o un chip de sesión local.Pestañas, vista dividida, búsqueda en la salida, la barra de entrada, gestos y todas las herramientas de abajo.
Pantalla SSHConexión Rápida o Explorar Hosts en la pantalla de inicio.Pestañas remotas con su propio juego de 32 herramientas. Se cuenta en la página de SSH.
Panel de herramientas acopladoAutomático en pantallas anchas (660 dp o más, sin vista dividida).Una tira de iconos con la herramienta abierta debajo. 20 herramientas en el shell local.
Menú de herramientasEl botón de la llave (Más opciones) de la barra de pestañas, cuando no hay panel acoplado.Seis categorías en el shell local, Buscar acción… y una fila de FRECUENTES. Abre cualquier herramienta como hoja a pantalla completa.
FragmentosHerramienta del panel; menú → Fragmentos.98 comandos predefinidos, los tuyos, carpetas y Generar con IA.
Historial de ComandosHerramienta del panel; menú → Sesión.Busca, marca con estrella, repite y borra los comandos que enviaste desde esta pestaña.
ArchivosHerramienta del panel; menú → Herramientas Linux.Navega por carpetas, crea una carpeta o un archivo, muestra un archivo y borra (con confirmación previa).
Panel de GitHerramienta del panel; menú → Herramientas Linux.Estado, ramas, historial y acciones sobre un repositorio, con JGit.
ProcesosHerramienta del panel; menú → Herramientas Linux.Lista, filtra, ordena y mata procesos.
Info del SistemaHerramienta del panel; menú → Herramientas Linux.SO, kernel, uptime, usuario y el modelo y la versión de Android del móvil.
Uso de DiscoHerramienta del panel; menú → Herramientas Linux.Una tarjeta por partición con una barra de uso.
RedHerramienta del panel; menú → Herramientas Linux.Ejecuta ping, nslookup, traceroute, curl, wget o dig contra un destino.
Variables de EntornoHerramienta del panel; menú → Herramientas Linux.Lista, busca, añade, edita y borra variables.
Gestor de AliasHerramienta del panel; menú → Sesión.Lista, crea, ejecuta y quita alias.
Trabajos en Segundo PlanoHerramienta del panel; menú → Sesión.Lista los trabajos, mata uno o tráelo a primer plano.
Scripts Rápidos (Pro)Herramienta del panel; menú → Automatización.Guarda scripts de varias líneas y ejecútalos línea a línea.
Macros de Teclado (Pro)Herramienta del panel; menú → Automatización.Guarda secuencias de teclas y envíalas a la sesión.
Reglas Expect (Pro)Herramienta del panel; menú → Automatización.Responde solo cuando un patrón aparece en la salida.
GrabaciónHerramienta del panel; menú → Sesión → Iniciar Grabación.Graba la pestaña como un archivo .cast de asciinema.
Registros de sesiónHerramienta del panel; menú → Configuración.Registra una sesión en un archivo cifrado, márcalo, coméntalo y compártelo.
Comparte tu servidorHerramienta del panel; menú → Sesión.Da un enlace público temporal al servidor de desarrollo que corre en tu móvil.
PerfilesHerramienta del panel; menú → Seguridad.Crea y lanza perfiles de terminal (mira los límites).
Sync y Equipos e Importar / ExportarHerramientas del panel; menú → Configuración.También están en el panel local. Se describen en la página de SSH.
Explicar con IABotón de destellos de la barra de entrada, solo tras una salida que parece un fallo.Recibe una explicación en lenguaje llano de las últimas 40 líneas.
¿Copiar al portapapeles?Aparece solo cuando un programa pide tu portapapeles (OSC 52).Copiar, Ignorar o permitirlo durante el resto de la sesión.
El comando lee credenciales y envía datos fueraAparece antes de ejecutar un comando así escrito en la barra de entrada.Lee qué toca y luego Ejecutar igualmente o cancela.

La pantalla de inicio

La pantalla de inicio es la entrada del módulo. Muestra el título Terminal y la línea «Shell local, SSH remoto y herramientas Linux en un solo lugar».

Shell local

Abre un shell en este móvil, en la pantalla Terminal. Una línea de estado bajo el nombre dice Herramientas Busybox listas cuando BusyBox está enlazado, o Shell básico cuando solo hay el shell de Android.

Conexión Rápida y Explorar Hosts

Abren la pantalla SSH con la hoja Conexión Rápida o la de Hosts. Se cuenta en la página de SSH.

Sesiones abiertas

Los chips sobre las tarjetas listan las sesiones que siguen en marcha, para volver a una de ellas.

En pantalla estrecha las tarjetas van en columna; en pantalla ancha el título queda a la izquierda y las tarjetas a la derecha. Atrás desde aquí sale del Terminal.

Puedes

  • Empezar un shell local con un toque en Shell local.
  • Retomar cualquier sesión en marcha, local o remota, desde los chips.
  • Ir a la pantalla SSH con Conexión Rápida o Explorar Hosts.

No puedes, y por qué

  • Fiarte del estado de BusyBox en una instalación nueva: se lee una sola vez al dibujar la pantalla y BusyBox se enlaza la primera vez que abres un shell, así que la tarjeta puede decir Shell básico hasta que vuelvas a abrir el Terminal.Aún no

El shell local

El shell local es un proceso real en tu móvil, no una emulación.

  • El Linux de la app. Un Alpine Linux opcional para móviles ARM de 64 bits. Se prepara desde la herramienta Linux completo. A partir de ahí Shell local abre Alpine y dice Full Linux tools, con apk add para los paquetes y tus proyectos en ~/projects. Tus proyectos y tu carpeta personal se quedan al repararlo o quitarlo; lo instalado con apk se va.
  • Una orden que falta. Cuando el shell responde sh: php: not found con una herramienta conocida, una barra sobre la entrada te dice qué hacer: Install (~11 MB) en Alpine, Abrir Linux en el shell básico o Preparar Linux si aún no está instalado.
  • Shell. ash de BusyBox v1.34.1, incluido en la app y lanzado sobre un pseudo-terminal nativo (TERM=xterm-256color, se redimensiona con la pantalla). Si BusyBox no está disponible, cae al sh del propio Android.
  • Applets. El binario de BusyBox exporta 373 applets. La primera vez que abres un shell PocketCode los enlaza todos, entre ellos awk, vi, sed, find, tar, gzip, unzip, wget, nc, ping, nslookup, traceroute, ifconfig, ip, netstat, top y less. Si ese paso falla, enlaza una lista básica de 70. Los enlaces se reparan la siguiente vez que abres un shell tras actualizar la app.
  • Node. node se enlaza en el shell cuando la compilación lo trae para la arquitectura de tu dispositivo (arm64-v8a y x86_64), con NODE_OPTIONS=--no-addons. npm no viene incluido.
  • Inicio. ~ es tu carpeta de proyectos. ls, grep y diff son alias con color y ll es ls -la (PocketCode comprueba el .ashrc del shell en cada arranque y lo restaura si difiere).
  • Base de datos. Mientras el motor PostgreSQL local está en marcha, DATABASE_URL y las variables PG* se definen solo en el shell local, nunca en las sesiones SSH.
  • Salida. La salida es una lista de líneas (las últimas 10.000 por pestaña). Se dibujan colores y estilos (16, 256 y RGB, negrita, tenue, cursiva, subrayado), los retornos de carro colapsan las barras de progreso y funcionan el retroceso y los tabuladores. Se descartan el movimiento del cursor, el borrado de pantalla, el ratón y otras secuencias de control.
Este shell corre con los permisos de la propia PocketCode, así que ve los ficheros de la app, igual que cualquier código que ejecutes aquí. No es un sandbox. La primera vez que lo usas un aviso lo dice. Las hojas de herramientas (Archivos y las demás) se quedan dentro de tu carpeta de proyectos y nunca abren las carpetas que guardan credenciales, pero esa regla es para las pantallas de la app, no para el shell.
The local shell on a phone after uname -a, free -h and ls -la, with the Local Shell tab and the input bar
El shell local en un móvil
A Local Shell tab on a phone with split, search and wrench buttons, command output and the input bar with attach, previous command and send
Una pestaña de shell local: barra de pestañas, salida y barra de entrada con Adjuntar archivo, Comando anterior y Enviar

Qué no hay, y por qué

  • Un gestor de paquetes en el shell básico: no hay apt, dpkg ni pkg. Para instalar paquetes, prepara el Linux de la app y usa apk.​Google Play
  • git. Usa el Panel de Git (habla con JGit) o el Control de código fuente del editor.A propósito
  • python, docker, curl, ssh, scp, zip y nano en el shell básico: no están en la compilación de BusyBox. La mayoría se instala con apk en el Linux de la app; Docker no está disponible ahí. Para otra máquina, usa la pantalla SSH.Google Play
  • Root, chroot/proot o una distribución Linux: el shell tiene el usuario de la app y nada más.Dispositivo
  • Programas que redibujan toda la pantalla, como vi, top o less: no se dibujan como pantalla porque se descarta el movimiento del cursor. top -n 1 está como chip en Procesos.​A propósito

Sesiones, pestañas y gestos

Cada pestaña es una sesión. La barra de pestañas es la misma en la pantalla local y en la SSH, pero cada pantalla muestra solo su tipo de pestaña.

Pestañas, vista dividida y búsqueda

  • + abre otro shell local en esta pantalla (en la pantalla SSH abre la hoja de Hosts).
  • Mantén pulsada una pestaña para Renombrar y Cerrar otras pestañas (una pestaña remota ofrece además Duplicar sesión). Cerrar una pestaña local es inmediato; cerrar las demás pregunta antes.
  • Cada pestaña lleva un punto de estado (una local es siempre verde) y sale un punto extra en la pestaña que recibió salida nueva mientras mirabas otra. Los chips LOG y REC aparecen en la barra mientras el registro o la grabación están activos.
  • El botón de división cicla Split Horizontal, Split Vertical y Sin Split. El segundo panel muestra la pestaña siguiente, el panel activo tiene un borde de acento y un toque en un panel le da el foco. La vista dividida es Pro.
  • La lupa (Buscar en Output) abre Buscar en el output… con un contador («N de M») y botones de anterior y siguiente. Busca el texto en cualquier parte de la línea, sin distinguir mayúsculas, y cada panel dividido se busca por separado.
  • Difundir (enviar lo que escribes a todas las pestañas conectadas) y Shell Multiplexado son de las pestañas remotas. Se cuentan en la página de SSH.
Gratis permite una sesión activa por pantalla: una en la pantalla Terminal (un shell local o un puerto serie) y otra en la pantalla SSH, así que un shell local y una sesión SSH pueden convivir. Las pestañas vacías o caídas no cuentan. Pedir una segunda en la misma pantalla (el botón +, Shell local con una ya abierta, o duplicar) muestra Terminal Pro con los botones Desbloquear Terminal Pro y Seguir con plan básico.

Gestos y teclas

Doble toque en la salidaEnvía Ctrl+C para detener el comando en curso.
Deslizar sobre la salidaEnvía flechas: izquierda y derecha mueven el cursor, arriba y abajo recorren el historial del shell.
Pellizcar la salidaCambia el tamaño del texto, de 8 a 24. Se recuerda el tamaño.
Pulsación larga en la salidaUn menú con Copiar línea, Copiar Output y Limpiar Terminal.
Tocar un enlaceUna dirección web se abre en el navegador.
Botones de volumenHacen de flechas arriba y abajo con Botones de volumen: ON. Viene apagado y el interruptor está en el menú de herramientas, en Configuración.

La barra de entrada

  • Un campo de una línea con Enviar. Todo lo que envías desde aquí se añade al historial de comandos de esta pestaña.
  • Mientras escribes salen hasta cinco sugerencias: comandos conocidos, comandos del historial de esta pestaña y rutas que empiezan por / o ~ (solo en el shell local, un nivel de profundidad).
  • Comando anterior retrocede por el historial de esta pestaña.
  • Adjuntar archivo elige un archivo. En el shell local se copia a tu carpeta de proyectos, con (1), (2) si el nombre ya existe, y su ruta se inserta en el campo. En una pestaña remota se sube a /tmp.
  • Explicar con IA aparece cuando la última salida parece un fallo (mira más abajo).

Límites de la pantalla de sesión

  • Una fila de teclas extra (ESC, TAB, Ctrl, F1 a F12). Las únicas teclas que puedes enviar son Ctrl+C (doble toque), las flechas (deslizar) y lo que envíe un macro.Aún no
  • Abrir un archivo desde la salida: las rutas y las referencias archivo:línea:columna se resaltan pero no reaccionan al toque. Solo se abren las direcciones web.Aún no
  • Una segunda sesión en la misma pantalla en Gratis, y la vista dividida.Pro

Avisos que puede lanzar una sesión

¿Copiar al portapapeles? (OSC 52)

Aparece solo cuando un programa de la sesión pide poner texto en tu portapapeles.

Un comando, un script o un servidor remoto pueden pedirle al terminal que copie texto. PocketCode te pregunta antes, porque un texto pegado en un terminal puede ejecutar comandos.

Puedes

  • Leer «La sesión quiere copiar N caracteres al portapapeles» con una vista previa del texto.
  • Tocar Copiar o Ignorar.
  • Marcar Permitir durante el resto de esta sesión. Esa elección se guarda en memoria y se olvida al terminar la sesión.

No puedes, y por qué

  • Dejar que una sesión escriba en tu portapapeles sin preguntar.A propósito

El comando lee credenciales y envía datos fuera

Aparece cuando un comando que envías desde la barra de entrada toca un almacén de credenciales y además manda datos a algún sitio.

El diálogo dice qué toca el comando y adónde va. Es un aviso, no un muro: está para los comandos copiados de un tutorial o sugeridos por una IA, cuyo segundo efecto es fácil de pasar por alto.

Puedes

  • Leer las dos cosas que hace el comando.
  • Tocar Ejecutar igualmente para enviarlo, o cancelar.

No puedes, y por qué

  • Que bloquee el comando, o que detecte lo que no pasa por la barra de entrada.A propósito

El panel de herramientas

Casi todo lo que haces además de escribir comandos ocurre en las herramientas. Aparecen de una de dos formas, según la pantalla.

Las 20 herramientas del shell local, en el orden del panel

Fragmentos, Historial de Comandos, Archivos, Panel de Git, Procesos, Info del Sistema, Uso de Disco, Red, Variables de Entorno, Gestor de Alias, Trabajos en Segundo Plano, Scripts Rápidos, Macros de Teclado, Reglas Expect, Grabación, Registros de sesión, Comparte tu servidor, Perfiles, Sync y Equipos e Importar / Exportar. Una pestaña remota añade 12 más, 32 en total (mira la página de SSH).

Panel acoplado

En una pantalla ancha (660 dp o más) y sin vista dividida, un panel de 380 dp se acopla a la derecha: una tira de iconos con la herramienta elegida debajo. Siempre hay una herramienta elegida (Fragmentos la primera vez) y el panel recuerda la última. El chevron de la barra de pestañas (Contraer panel) lo pliega.

Menú de herramientas

En un móvil, o con la vista dividida activa, el botón de la llave (Más opciones) abre un menú con un campo de búsqueda (Buscar acción…), una fila de FRECUENTES (una acción entra ahí tras dos usos, seis como máximo) y estas categorías:

CategoríaAcciones en el shell local
SesiónComparte tu servidor, disposición dividida, Historial de Comandos, Gestor de Alias, Trabajos en Segundo Plano, Copiar Output, Limpiar Terminal, Iniciar Grabación
Herramientas LinuxArchivos, Procesos, Red, Uso de Disco, Info del Sistema, Variables de Entorno, Panel de Git
FragmentosTodos los Fragmentos y ocho atajos de categoría (Sistema, Docker, Git, Base de Datos, Seguridad, Monitoreo, Redes, Archivos y Texto)
AutomatizaciónMacros de Teclado, Scripts Rápidos, Reglas Expect
SeguridadPerfiles
ConfiguraciónRegistros de sesión, Sync y Equipos, Importar / Exportar, Botones de volumen: ON / Botones de volumen: OFF

En una pestaña SSH hay una séptima categoría, Conexión, y más acciones en las otras. Copiar Output y Limpiar Terminal también están en el menú de pulsación larga de la salida.

The tools menu on an SSH tab: a search field and the categories Connection, Session, Linux Tools, Snippets, Automation and Security, each with an action count
El menú de herramientas, aquí en una pestaña SSH: categorías con el número de acciones de cada una (el shell local no tiene la categoría Conexión)
  • Llegar a Botones de volumen: ON/OFF en una tablet ancha con el panel acoplado: el menú de herramientas no se dibuja ahí. (Al activar la vista dividida vuelve la llave.)Dispositivo

Herramientas Linux

Estas herramientas son atajos para cosas que si no tendrías que escribir. Las listas que muestran las lee un shell aparte, no interactivo (cada lectura tiene un tope de 15 segundos y 512 KB). Lo que cambias desde ellas (crear, borrar, matar, exportar) se escribe en tu sesión como un comando normal, así que también lo ves en la salida.

Archivos

Herramienta del panel Archivos; menú → Herramientas Linux.

Un explorador de carpetas construido sobre ls -la.

Puedes

  • Abrir carpetas y subir un nivel con Superior.
  • Crear una carpeta (Nueva carpeta, mkdir -p) o un archivo vacío (Nuevo archivo, touch).
  • Tocar un archivo para mostrarlo en la sesión con cat.
  • Borrar una entrada con su icono de papelera. Un diálogo Eliminar con el título ¿Eliminar <nombre>? pregunta antes: el archivo, o la carpeta y todo lo que contiene, se elimina para siempre, sin papelera ni deshacer. Eliminar confirma; Cancelar lo deja como está.
  • El rm -rf que se escribe en la sesión lleva la ruta entre comillas y los caracteres especiales escapados, así que un archivo llamado $(…) se borra por su nombre y nunca se ejecuta.
  • Usar los chips de Comandos rápidos: du -sh *, find . -name '*.log' y chmod +x.

No puedes, y por qué

  • Navegar fuera de tu carpeta de proyectos: el explorador se detiene ahí, y las carpetas que guardan credenciales de la app nunca se abren.A propósito
  • Deshacer un borrado, o mandarlo a una papelera.A propósito
  • Ver propietario, tamaño o fechas más allá de lo que imprime ls -la.​Aún no

Panel de Git

Herramienta del panel Panel de Git; menú → Herramientas Linux.

Un panel de Git pequeño con cuatro pestañas: Estado, Ramas, Historial y Acciones. En el shell local usa JGit (no hay programa git); en una pestaña SSH escribe comandos git en el shell remoto. Busca el repositorio subiendo desde la carpeta de Archivos, o desde tu carpeta de proyectos.

Puedes

  • Inicializar repositorio donde estás, Añadir todo y quitar todo de la preparación.
  • Escribir un mensaje y Confirmar cambios.
  • Push, Pull, Fetch, Stash, Stash Pop.
  • Cambiar de rama o crear una con Nueva rama, y descartar los cambios de un archivo.

No puedes, y por qué

  • Un git diff completo o reset: el panel local no dibuja las acciones que JGit no puede hacer. La nota al pie del propio panel remite al Control de código fuente del editor.A propósito
  • Iniciar sesión en un host de Git desde aquí: push y pull usan las credenciales ya configuradas en otra parte de la app, y un fallo muestra su mensaje en la hoja.A propósito
  • Trabajar sobre un repositorio fuera de tu carpeta de proyectos.A propósito

Procesos

Herramienta del panel Procesos; menú → Herramientas Linux.

Los procesos en marcha, leídos con ps.

Puedes

  • Ver PID, nombre, usuario, CPU %, MEM % y estado.
  • Filtrar por nombre o PID (Filtrar procesos…).
  • Ordenar por CPU %, MEM % o PID.
  • Detener un proceso con su icono de matar, que escribe kill -9 <pid> en la sesión.
  • Usar los chips top -n 1, ps aux --sort=-%mem | head -20 y uptime, y actualizar la lista.

No puedes, y por qué

  • Elegir otra señal (siempre es -9) o filtrar por usuario.Aún no
  • Mostrar un árbol de procesos.Aún no

Info del Sistema

Herramienta del panel Info del Sistema; menú → Herramientas Linux.

Tres pestañas de tarjetas: Resumen (SO, kernel, uptime), Hardware (arquitectura, más el modelo del móvil, la versión de Android y el nivel de SDK) y Entorno (usuario e id).

Puedes

  • Refrescar las tarjetas.
  • Usar los chips: uname -a, uptime, whoami, free -h y env | sort envían lo que dicen. cpuinfo envía cat /proc/cpuinfo, model envía getprop ro.product.model (con el nombre de producto de DMI como alternativa), $PATH envía echo $PATH y $SHELL envía echo $SHELL.

No puedes, y por qué

  • Ver memoria, CPU o nombre de host como tarjetas propias.Aún no

Uso de Disco

Herramienta del panel Uso de Disco; menú → Herramientas Linux.

Una tarjeta por partición, a partir de df -hP, con una barra de uso y los tamaños Usado, Libre y Total.

Puedes

  • Refrescar las tarjetas.
  • Usar los chips df -h, du -sh * | sort -rh | head -20 y find / -size +100M 2>/dev/null.

No puedes, y por qué

  • Ver inodos o más que las columnas de df -hP.​Aún no

Red

Herramienta del panel Red; menú → Herramientas Linux.

Al abrirla ejecuta ifconfig (o ip addr) y muestra el resultado. La salida aparece en la hoja como texto monoespaciado, no en la sesión.

Puedes

  • Elegir una herramienta (ping con 5 paquetes, nslookup, traceroute, curl para cabeceras, wget como comprobación de alcance, dig), escribir un host, dirección o URL y tocar Ejecutar.
  • Usar los chips ifconfig, netstat -tlnp y ss -tuln.

No puedes, y por qué

  • Ejecutar curl o dig en el shell local: la compilación de BusyBox no los incluye, así que terminan con un mensaje de no encontrado.Google Play
  • Ejecutar nada durante más de 15 segundos ni imprimir más de 512 KB.A propósito

Variables de Entorno

Herramienta del panel Variables de Entorno; menú → Herramientas Linux.

Las variables, listadas con env y con búsqueda.

Puedes

  • Añadir una con Nueva variable (el nombre debe empezar por letra o guion bajo y usar solo letras, dígitos y guiones bajos). Se envía como export NOMBRE='valor'.
  • Editar una con Editar variable, o borrarla, lo que envía unset.

No puedes, y por qué

  • Estar seguro de que la lista coincide con tu sesión abierta: la lee un shell aparte, así que una variable que hayas hecho export a mano puede no salir.A propósito

Gestor de Alias

Herramienta del panel Gestor de Alias; menú → Sesión.

Los alias de la sesión, listados con alias.

Puedes

  • Crear uno con Nuevo Alias (letras, dígitos, guion bajo y guion en el nombre). Se envía como alias nombre='comando'.
  • Tocar un alias para ejecutarlo, o borrarlo (unalias).
  • Tocar uno de los cuatro Sugeridos (ll, cls, gs, ..). gs es git status, que el shell local no puede ejecutar.

No puedes, y por qué

  • Conservar los alias al cerrar el shell: PocketCode comprueba .ashrc en cada arranque del shell y lo reescribe si difiere de una plantilla fija, así que las ediciones no sobreviven.A propósito
  • Estar seguro de que la lista coincide con tu sesión abierta: la lee un shell aparte.A propósito

Trabajos en Segundo Plano

Herramienta del panel Trabajos en Segundo Plano; menú → Sesión.

Los trabajos, listados con jobs -l. Si no hay ninguno, la hoja dice «Sin trabajos en ejecución» y «Usa comando & para ejecutar en segundo plano».

Puedes

  • Matar un trabajo (kill <pid>; se rechaza un pid de 1 o menos, o el de la propia app).
  • Traer un trabajo a primer plano (fg %N).

No puedes, y por qué

  • Ver los trabajos del shell en el que escribes: la lista viene de un shell aparte, así que los trabajos que lanzaste con & en tu pestaña normalmente no salen.A propósito

Fragmentos e historial

Comandos reutilizables y los comandos que ya ejecutaste.

Fragmentos

Herramienta del panel Fragmentos (con la que se abre el panel); menú → Fragmentos.

98 comandos listos para usar en 14 categorías, sembrados la primera vez que corre el terminal, más los tuyos. En el shell local se ocultan los seis de Paquetes, así que se ven 92.

Puedes

  • Filtrar por chip de categoría (Sistema, Docker, Git, Nginx, Node/PM2, Base de datos, Seguridad, Deploy/CI-CD, Monitoreo, Red, Paquetes (solo en pestañas SSH), Archivos, Texto, Usuarios, Personalizado) y por carpeta.
  • Tocar un fragmento para poner su comando en la barra de entrada. No se ejecuta hasta que lo envías.
  • Crear uno con Nuevo Fragmento: nombre, comando, categoría, descripción y carpeta. Generar con IA convierte una frase como «buscar archivos de más de 100MB» en un fragmento. Necesita un proveedor de IA conectado y pide consentimiento la primera vez.
  • Mover un fragmento a una carpeta, crear o borrar carpetas, y borrar fragmentos.
  • Usar marcadores: ${DATE} (yyyy-MM-dd), ${DATETIME} (yyyy-MM-dd_HH:mm:ss) y ${TIMESTAMP} (milisegundos) se rellenan al tocar el fragmento. ${HOST}, ${USER} y ${PORT} se rellenan en una pestaña abierta desde un host guardado. Todo lo demás se deja tal cual, salvo las variables de entorno del grupo o del perfil de un host guardado.
  • Guardar hasta 10 fragmentos propios en Gratis: los 98 predefinidos no cuentan para el tope.

No puedes, y por qué

  • Tener más de 10 fragmentos propios en Gratis. Los 98 predefinidos no cuentan, así que el botón + (lleva una marca PRO) abre Terminal Pro solo cuando ya tienes 10 propios. Una importación que trae fragmentos se detiene en el mismo tope.Pro
  • Ver los fragmentos de Paquetes en el shell local: no hay gestor de paquetes para ejecutarlos.Google Play
  • Rellenar ${HOST}, ${USER} o ${PORT} en una pestaña local: sin host se quedan como están escritos.A propósito

Historial de Comandos

Herramienta del panel Historial de Comandos; menú → Sesión.

Los comandos que enviaste desde la barra de entrada de esta pestaña.

Puedes

  • Buscar con Buscar comandos….
  • Marcar un comando con estrella para guardarlo en Favoritos.
  • Ejecutar un comando otra vez, o borrarlo.
  • Tocar Limpiar. El diálogo dice «Se eliminarán todos los comandos del historial de esta pestaña. Los favoritos se mantendrán.»

No puedes, y por qué

  • Conservar el historial al cerrar la pestaña o compartirlo entre pestañas: guarda los últimos 100 comandos por pestaña y vive en memoria.A propósito
  • Ver lo que escribiste directamente en el shell: solo se registran los comandos enviados desde la barra de entrada.A propósito

Automatización (Pro)

Scripts Rápidos, Macros de Teclado y Reglas Expect son Pro: la puerta está al guardarlos, y al ejecutar un Script Rápido. En Gratis las hojas se abren, llevan una marca PRO y al intentar guardar aparece Terminal Pro. El paywall los lista como Automatización avanzada (Expect rules, Watchdog, Macros).

Scripts Rápidos

Herramienta del panel Scripts Rápidos; menú → Automatización.

Scripts de varias líneas que envías a la sesión con un toque.

Puedes

  • Crear un script con Nuevo Script (nombre, descripción y el texto del script), buscarlos, editarlos y borrarlos.
  • Tocar Ejecutar: cada línea se envía a la sesión con 150 ms entre líneas. Se saltan las líneas vacías y las que empiezan por #.

No puedes, y por qué

  • Guardar o ejecutar un script sin Pro.Pro
  • Parar un script a medias, u ordenarlos por categoría: no hay botón de parar y el formulario no pide categoría.Aún no

Macros de Teclado

Herramienta del panel Macros de Teclado; menú → Automatización.

Una secuencia de teclas con nombre que se envía a la sesión como bytes en bruto.

Puedes

  • Agregar macro: un nombre, la Secuencia de teclas y una descripción opcional.
  • Tocar un macro para enviarlo, o borrarlo.
  • Usar estos escapes en la secuencia, y solo estos: \n (Enter), \t (Tab), \x1b (ESC), \x03 (Ctrl+C), \x04 (Ctrl+D) y \x1a (Ctrl+Z).

No puedes, y por qué

  • Crear un macro sin Pro.Pro
  • Poner botones de macros en la barra de entrada: los macros solo se ejecutan desde esta hoja.Aún no

Reglas Expect

Herramienta del panel Reglas Expect; menú → Automatización.

Cuando un patrón aparece en la salida, PocketCode escribe una respuesta por ti. Las reglas se comprueban línea a línea sobre la salida de todas las sesiones abiertas, y solo responde la primera regla que coincide con una línea.

Puedes

  • Agregar regla: un Patrón a detectar, Usar regex (apagado significa que la línea contiene el texto, sin distinguir mayúsculas; encendido, que la expresión regular se encuentra en cualquier parte de la línea), una Respuesta automática y una descripción.
  • Activar o desactivar una regla, o borrarla.

No puedes, y por qué

  • Crear una regla sin Pro.Pro
  • Añadir un salto de línea a la respuesta: PocketCode ya pulsa Enter después (la hoja dice «La respuesta se enviará automáticamente + Enter»), así que un \n la enviaría dos veces.A propósito

Perfiles

Los perfiles son la parte menos terminada del terminal. Se listan aquí porque la hoja está en el panel y en el menú.

Herramienta del panel Perfiles; menú → Seguridad.

Una lista de Perfiles de Terminal. Vienen cinco con la app: Default, Bash, Dev (Node), Docker y Python Env.

Puedes

  • Crear, editar, duplicar y borrar perfiles, y marcar uno como predeterminado.
  • Rellenar nombre, tipo de shell, ruta del shell, directorio de trabajo, tema, tamaño de fuente, comandos de inicio, variables de entorno, scrollback, campana, icono y color.
  • Tocar Lanzar para abrir una pestaña y enviar los comandos de inicio del perfil.

No puedes, y por qué

  • Conservar un perfil: los perfiles no se escriben en el almacenamiento, así que no cuentes con ellos tras reiniciar la app.Aún no
  • Que se apliquen el tipo de shell, el tema, la fuente, el entorno o el directorio de trabajo: Lanzar hace poco más que abrir una pestaña y enviar los comandos de inicio.Aún no
  • Crear un perfil para un host SSH: el formulario no tiene selector de host.Aún no
  • Ejecutar los comandos de los perfiles de fábrica: Docker y Python no están en el shell local.Google Play

Grabación y registros

Dos formas de guardar lo que imprimió una sesión. Las dos son Gratis.

Grabación

Herramienta del panel Grabación; menú → Sesión → Iniciar Grabación.

«Guarda la sesión como un archivo .cast de asciinema que puedes reproducir después.» El archivo es asciicast v2, se llama session_<nombre>_<fecha>.cast y no está cifrado.

Puedes

  • Iniciar Grabación y Detener Grabación en la pestaña enfocada. El chip REC se muestra mientras corre.
  • Ver tus archivos en Grabaciones guardadas.
  • Encontrar la grabación también en Registros de sesión: se guarda en el mismo almacén, así que puedes marcarla y compartirla allí, y cuenta para el tope de 100.

No puedes, y por qué

  • Reproducir una grabación dentro de la app: solo se lista. Reprodúcela con asciinema en otro sitio.Aún no

Registros de sesión

Herramienta del panel Registros de sesión; menú → Configuración.

Un registro en texto plano de todo lo que imprimió una sesión, guardado cifrado en el dispositivo (AES-256-GCM, con una clave guardada en el Keystore de Android). El texto plano existe solo mientras registras; al parar, el archivo se sella.

Puedes

  • Iniciar registro y Detener registro. El chip LOG se muestra mientras corre.
  • Usar Marcar en un registro (una estrella), añadir un Comentario («Qué pasó, por qué importa») y activar Solo marcados.
  • Compartir un registro: se descifra a una copia temporal y se entrega a la hoja de compartir del sistema.

No puedes, y por qué

  • Guardar más de 100 registros: se descartan los más antiguos, salvo los que marcaste.A propósito
  • Buscar registros por texto o fecha: solo ves la fecha de cada registro y el filtro de marcados.Aún no

Comparte tu servidor

Un enlace público al servidor de desarrollo que corre en tu móvil.

Herramienta del panel Comparte tu servidor; menú → Sesión.

Con un servidor de desarrollo corriendo en el móvil (lanzado desde un proyecto), la hoja dice «Dale una dirección pública al servidor que corre en este móvil, en el puerto N». El enlace sale por un reenvío remoto SSH hacia localhost.run: sin cuenta y sin instalar nada.

Puedes

  • Tocar Crear enlace y luego Copiar enlace. Si falla, Reintentar.
  • Tocar Dejar de compartir cuando quieras. El enlace también se cierra solo cuando el servidor de desarrollo se detiene.

No puedes, y por qué

  • Compartir sin servidor: la hoja dice «No hay ningún servidor corriendo. Abre un proyecto primero.»A propósito
  • Mantener la misma dirección o usar tu propio dominio: el enlace es temporal («cambia cada vez y se acaba al dejar de compartir») y cualquiera que lo tenga puede entrar al servidor mientras compartes.Terceros
  • Compartir sin conexión.Requiere red

Explicar con IA

Ayuda en lenguaje llano cuando un comando falla.

El botón de destellos (Explicar con IA) de la barra de entrada. Solo aparece cuando la última salida parece un fallo.

PocketCode envía las últimas 40 líneas de la pestaña (8 KB como máximo) a tu proveedor de IA conectado, con los secretos tapados antes, y muestra la respuesta en Explicación de IA: qué falló, por qué y qué ejecutar después. Espera hasta 60 segundos. Usas tu propio proveedor, así que a PocketCode no le cuesta nada.

Puedes

  • Leer la explicación y tocar Copiar la explicación.
  • Leer la línea bajo el título: «Se mandan las últimas 40 líneas a tu proveedor de IA, con los secretos tapados.»

No puedes, y por qué

  • Usarlo sin un proveedor de IA conectado en Ajustes: la hoja dice «No llegó ninguna explicación. Comprueba que tienes un proveedor de IA conectado en Ajustes y vuelve a intentarlo.»Requiere red
  • Ejecutar desde un botón el comando que sugiere la IA: la hoja solo lo muestra y lo copia. El texto no se guarda.A propósito

Apariencia

Los colores y las fuentes no se ajustan en el propio Terminal.

  • En Configuración, dentro de Apariencia, abre Apariencia del terminal: tema, fuente, tamaño de texto, imagen de fondo y opacidad del fondo.
  • Hay 11 temas de terminal más Igual que la app, que sigue a la app (12 tarjetas en el selector). Cinco son gratis (Igual que la app, PocketCode Dark, PocketCode Light, Dark y Light) y siete son Pro (Dracula, Solarized Dark, Monokai, One Dark, Catppuccin Mocha, Gruvbox Dark y Nord). Los temas de terminal instalados desde el Marketplace también son Pro.
  • Pellizcar la salida también cambia el tamaño del texto (de 8 a 24).

SSH, SFTP y herramientas remotas

La pantalla SSH, SFTP y todo lo remoto tienen su propia página. Comparten la barra de pestañas, el panel y el menú que acabas de leer, con 12 herramientas más (32 en total).

  • Dónde está: hosts y grupos, Conexión Rápida, claves de host e inicio de sesión keyboard-interactive, claves SSH (incluidas las vinculadas al dispositivo), SFTP, reenvío de puertos, Watchdog, Webhooks, el gestor de paquetes, proveedores cloud, serie y escritorio remoto.
  • También en este panel: Sync y Equipos e Importar / Exportar aparecen también en la lista de herramientas locales. Se describen en la página de SSH. En Sync y Equipos, alojar, buscar o unirte a una sala de equipo hace que Android pida el permiso de red local (dispositivos cercanos) desde Android 13, y la explicación de ese permiso y los errores de conexión salen en el idioma de la app.
  • Pro en pestañas remotas: un segundo host guardado, un segundo reenvío de puertos, Difundir, Watchdog y Webhooks. Sus límites están en la página de SSH.

Gratis y Pro

Lo que el terminal local limita. Todo lo demás es Gratis.

FunciónGratisPro
Sesiones activas a la vez, por pantalla (Terminal y SSH tienen cada una su hueco)1Sin límite
Vista divididaNo incluidaIncluida
Crear Macros de Teclado, Scripts Rápidos y Reglas Expect (y ejecutar Scripts Rápidos)No incluidoIncluido
Tus propios fragmentosHasta 10; los 98 predefinidos no cuentan. Pasados 10, añadir o importar uno abre Terminal ProSin tope
Temas de terminal4 integrados más Igual que la appLos 11 más Igual que la app, más los temas del Marketplace
Fuentes del terminalSolo DefaultDefault y 7 más
Shell local, herramientas Linux, Panel de Git, historial, alias, entorno, grabación, registros de sesión, Comparte tu servidor, Explicar con IA, PerfilesIncluidoIncluido
Toda acción Pro del Terminal muestra el mismo muro, Terminal Pro, con Desbloquear Terminal Pro y Seguir con plan básico. En las pestañas SSH, un segundo host guardado o reenvío de puertos, Difundir, Watchdog y Webhooks también son Pro y se cuentan en la página de SSH. Las funciones de IA del terminal usan tu propio proveedor y no tienen puerta. Mira Planes y precios

Privacidad y seguridad

  • El shell local corre con los permisos de la propia PocketCode y no es un sandbox. Un aviso (Sobre este terminal) lo dice la primera vez que lo usas.
  • Tus proyectos están en ~. Las hojas de herramientas se quedan dentro de esa carpeta y nunca abren las carpetas que guardan credenciales de la app.
  • Los registros de sesión se cifran en el dispositivo con AES-256-GCM y una clave del Keystore. Las grabaciones son archivos .cast sin cifrar. Compartir un registro lo descifra a una copia temporal.
  • El historial de comandos se guarda en memoria, los últimos 100 comandos por pestaña, y no se escribe en disco.
  • Un comando que envías desde la barra de entrada y que lee un almacén de credenciales y además envía datos fuera lanza un aviso antes de ejecutarse.
  • Un programa no puede escribir en tu portapapeles sin una confirmación (OSC 52).
  • DATABASE_URL y las variables PG* del motor PostgreSQL local se definen solo en el shell local, y solo mientras el motor corre. Nunca se envían a las sesiones SSH.
  • Lo que sale del dispositivo a propósito: Explicar con IA envía las últimas 40 líneas, con los secretos tapados y tras un consentimiento único, al proveedor de IA que conectaste. Generar con IA en los fragmentos envía tu frase al mismo proveedor. Comparte tu servidor pasa por localhost.run mientras compartes.

Limitaciones

Los límites principales del terminal local, cada uno con su motivo. El detalle está en las secciones de arriba.

  • Los programas que redibujan la pantalla (vi, top, less) no se muestran como pantalla.A propósito
  • En el shell básico: sin gestor de paquetes, git, python, docker, curl, ssh ni zip.​Google Play
  • Sin root y sin distribución Linux: el shell tiene el usuario de la app.Dispositivo
  • PocketCode funciona en dispositivos de 64 bits (arm64-v8a y x86_64) con Android 9 o posterior. No hay compilación de 32 bits.Dispositivo
  • Una sola sesión activa por pantalla en Gratis, y sin vista dividida, macros, scripts ni reglas expect.Pro
  • No hay fila de teclas extra (ESC, TAB, Ctrl, F1 a F12), y las rutas de la salida no se abren.Aún no
  • Los perfiles no se guardan y casi ninguno de sus campos se aplica; las grabaciones no se pueden reproducir en la app.Aún no
  • Las listas de entorno, alias y trabajos las lee un shell aparte, no tu sesión abierta.A propósito
  • En una tablet ancha con el panel acoplado no se muestra el menú de herramientas (ni su interruptor de volumen).Dispositivo
  • El enlace de Comparte tu servidor es temporal y necesita conexión.Terceros

Resolución de problemas

Shell básico

La tarjeta Shell local dice Shell básico cuando aún no encuentra el ash de BusyBox. BusyBox se enlaza la primera vez que abres un shell, y otra vez tras actualizar la app, así que abre el shell local una vez y vuelve: debería decir entonces Herramientas Busybox listas. Hasta entonces tienes el sh de Android, que no trae applets como awk o tar.

Terminal Pro

Pediste algo que Gratis no incluye: una segunda sesión en la misma pantalla, la vista dividida, guardar un Macro de Teclado, un Script Rápido o una Regla Expect, añadir un fragmento propio por encima de 10 o, en SSH, un segundo host guardado o reenvío de puertos. Seguir con plan básico cierra el muro; Desbloquear Terminal Pro abre el paywall.

El + de Fragmentos abre Terminal Pro

Ya tienes 10 fragmentos propios, el tope de Gratis; los 98 predefinidos no cuentan. Elimina uno para hacer sitio, o desbloquea Terminal Pro. Puedes seguir tocando cualquier fragmento predefinido para usarlo.

Aquí no hay un repositorio Git

El Panel de Git busca una carpeta .git desde la carpeta actual de Archivos hacia arriba, o desde tu carpeta de proyectos. Abre Archivos en la carpeta de tu proyecto, o toca Inicializar repositorio.

No llegó ninguna explicación. Comprueba que tienes un proveedor de IA conectado en Ajustes y vuelve a intentarlo.

Explicar con IA necesita un proveedor con clave o inicio de sesión. Conecta uno en los ajustes de IA y vuelve a intentarlo. También se rinde tras 60 segundos.

No se pudo generar un snippet — prueba a reformular

Generar con IA espera una petición en una frase y responde con un nombre, un comando de una línea y una descripción. Di qué quieres hacer, no el comando que imaginas.

No hay ningún servidor corriendo. Abre un proyecto primero.

Comparte tu servidor comparte el servidor de desarrollo que arrancó tu proyecto. Arranca antes el servidor desde el proyecto; la hoja mostrará entonces su puerto.

El comando lee credenciales y envía datos fuera

El comando que vas a ejecutar toca un almacén de credenciales y además manda datos a la red. Si lo copiaste de algún sitio, léelo antes de tocar Ejecutar igualmente.

¿Copiar al portapapeles?

Un programa de la sesión pidió poner texto en tu portapapeles. Toca Copiar solo si lo has pedido tú.

Abre una shell o conéctate a un host para grabar

Grabación graba la pestaña enfocada. Abre antes un shell local y entonces inicia la grabación.

No se pudo adjuntar el archivo / No se pudo preparar el registro para compartir

No se pudo copiar el archivo a la sesión, o no se pudo descifrar un registro para compartirlo. Inténtalo de nuevo; si sigue fallando, elige otro archivo o para y reinicia el registro.

No hay botón Explicar con IA

El botón solo aparece cuando la última salida parece un fallo. Ejecuta de nuevo el comando que falló, o lee la explicación desde la última salida con error.

Mi alias o variable ha desaparecido en un shell nuevo

Los alias y variables que creas desde las hojas viven solo en esa sesión; PocketCode restaura .ashrc en cada arranque. Guarda un comando que repites en un Script Rápido (Pro) o en un fragmento.