Estado actual: 0.5.0

Vision General

Dex no intenta esconder la terminal; la organiza.

Su objetivo es darte una capa mas clara y mas segura para tareas que haces todos los dias en Termux o Linux:

• detectar rapidamente en que proyecto estas
• inspeccionar estructura y archivos sin ruido
• ejecutar flujos seguros por lenguaje
• guardar accesos directos de modo seguro
• revisar entorno y configuracion antes de publicar o depurar

Instalacion

Instalacion global desde npm:

npm i -g dex-termux-cli

Uso local del proyecto:

node ./bin/dex --help

Comprobar que Dex quedo instalado:

dex --help

Lo Que Incluye

| Area | Funcion principal | Comandos | | --- | --- | --- | | Navegacion | Menu visual y ayuda contextual | dex -m, dex -h, dex -h <comando> | | Contexto | Deteccion de proyecto y prompt | dex -x, dex --prompt-context | | Exploracion | Busqueda y arboles | dex -b, dex -t | | Clipboard | Copiar, pegar, mover y limpiar | dex -c, dex -p, dex -k, dex -K | | Diagnostico | Auditoria del entorno y del proyecto | dex --doctor, dex --inspect | | Safe Mode | Instalacion segura, shell segura y accesos directos | dex -i, dex -r | | Acceso rapido | Entrada directa a Android o Linux | dex -a |

Uso Rapido

dex -m
dex --doctor
dex --inspect
dex -x
dex -b "*.js" --scope actual
dex -t . --depth 3
dex -c --name
dex -r
dex -r bot.py mi-bot
dex -r mi-bot
dex --list-safe-shortcuts

Vista Previa

dex --help

Dex CLI
Explorar, entender y preparar proyectos desde Termux o Linux.
Android storage aparece cuando el modo de plataforma lo permite.
Usa `dex -h <comando>` para ver la ayuda puntual de cada comando.

[Comandos principales]
  dex -m                 menu visual
  dex -v                 version local y publicada
  dex --doctor           revisar entorno y herramientas
  dex --inspect          resumir el proyecto actual
  dex -c                 copiar ruta o nombre actual
  dex -p                 pegar o mover lo copiado
  dex -x                 contexto del proyecto actual
  dex -t src             arbol completo de una ruta
  dex -r main.py bot     guardar acceso seguro
  dex -r bot             ejecutar acceso seguro

dex --inspect

Dex Inspect
Resumen del proyecto actual para decidir que mejorar antes de la siguiente release.

Resumen
----------------------------------------
Proyecto : /ruta/del/proyecto
Lenguaje : NODE
Version  : 18
Archivos : 2
Carpetas : 5

Metadatos
----------------------------------------
Paquete : dex-termux-cli
Version : 0.5.0
Gestor  : npm
Scripts : start, help, test

dex -r

Modo Dex : shell segura para MiProyecto
Proyecto : /storage/emulated/0/MiProyecto
Entorno  : /data/data/com.termux/files/home/.dex/venvs/miproyecto-ab12cd34
Python   : /data/data/com.termux/files/home/.dex/venvs/miproyecto-ab12cd34/bin/python
Shell    : bash interactiva

Dex: prompt cargado en /storage/emulated/0/MiProyecto
Dex@android /storage/emulated/0/MiProyecto [PYTHON]
>

dex -r bot.py mi-bot

Dex guardo un acceso seguro.
Nombre   : mi-bot
Proyecto : /storage/emulated/0/MiProyecto
Tipo     : PYTHON
Entrada  : bot.py
Comando  : python bot.py
Launcher : /data/data/com.termux/files/home/bin/dex-safe-mi-bot

Uso rapido:
  dex -r mi-bot
  /data/data/com.termux/files/home/bin/dex-safe-mi-bot

Comandos Principales

Navegacion y ayuda

• dex -m Abre el menu visual principal.
• dex -h Muestra la ayuda general.
• dex -h <comando> Muestra ayuda puntual de un comando especifico.

Contexto y diagnostico

• dex -x Detecta el proyecto actual y muestra su contexto.
• dex --doctor Revisa shell, storage, configuracion y runtimes visibles.
• dex --inspect Resume el proyecto actual con metadatos y archivos clave.

Exploracion

• dex -b "<patron>" --scope actual Busca archivos o carpetas por nombre o patron.
• dex -t . --depth 3 Renderiza un arbol legible de la ruta objetivo.
• dex -e <comando> Explica un comando conocido por Dex.

Clipboard interno

• dex -c Copia la ruta actual o el root del proyecto.
• dex -c --name Copia solo el nombre visible.
• dex -p Pega o mueve lo guardado.
• dex -k Consulta el estado del portapapeles de Dex.
• dex -K Limpia el portapapeles interno.

Safe Mode

• dex -i Instala dependencias usando el flujo seguro del lenguaje detectado.
• dex -r Abre la shell segura del proyecto actual.
• dex -r <archivo> <nombre> Guarda un acceso seguro reutilizable.
• dex -r <nombre> Ejecuta un acceso seguro guardado.
• dex --list-safe-shortcuts Lista accesos seguros guardados.
• dex --remove-safe-shortcut <nombre> Elimina un acceso seguro guardado.

Acceso rapido

• dex -a Abre el acceso rapido a Android storage o Linux.
• dex -v Compara la version local contra la publicada.

Flujos Recomendados

1. Revisar entorno antes de trabajar

dex --doctor
dex --inspect
dex -x

2. Explorar un proyecto desde cero

dex -t . --depth 2
dex -b "config" --scope actual
dex -e npm

3. Preparar y abrir modo seguro

dex -i
dex -r

4. Guardar un acceso directo seguro

Python:

dex -r bot.py bot

Node:

dex -r src/index.js api

Luego puedes lanzar directamente:

dex -r bot
dex -r api

Deteccion de Proyecto

Dex detecta automaticamente la raiz del proyecto aunque estes dentro de subcarpetas.

Lenguajes soportados actualmente:

• Python
• Node
• PHP
• Rust
• Go
• Java
• Ruby

Modo de Plataforma

Dex trabaja con tres modos:

• auto Detecta automaticamente si estas en Termux o Linux.
• termux Habilita comportamiento orientado a Android storage.
• linux Opera como entorno Linux puro.

La configuracion se guarda en:

~/.config/dex/config.json

Flujos Seguros por Lenguaje

| Lenguaje | Deteccion | Comportamiento seguro | | --- | --- | --- | | Python | pyproject.toml, requirements.txt, setup.py, Pipfile o .py | venv aislado | | Node | package.json, node_modules o .js/.ts/.mjs/.cjs | npm install o npm ci | | PHP | composer.json o .php | composer install --no-interaction | | Ruby | Gemfile o .rb | bundle install | | Go | go.mod | go mod download | | Rust | Cargo.toml | cargo fetch | | Java | pom.xml, build.gradle, build.gradle.kts | workspace seguro guiado |

Interfaz y Menu

El menu interactivo actual incluye:

• navegacion con flechas
• seleccion directa por 1-9
• Esc para volver o salir
• paginacion con ←/→ o PgUp/PgDn
• submenus para ajustes y funciones

Configuracion Disponible

Desde el menu puedes ajustar:

• modo de plataforma
• acceso rapido a Android o Linux
• detector de contexto del proyecto
• posicion del contexto en el prompt
• tema visual del prompt
• instalacion segura de proyectos

Estado del Proyecto

Actualmente Dex ya ofrece:

• salida visual mas clara y mas consistente
• ayuda contextual por comando
• doctor para auditar entorno
• inspect para resumir el proyecto activo
• modo seguro por lenguaje
• accesos directos del modo seguro
• portapapeles interno para rutas y nombres
• arboles con marcadores de proyecto

Desarrollo Local

Ejecutar ayuda local:

node ./bin/dex --help

Ejecutar tests:

node --test ./tests/*.test.js

Licencia

MIT