Saltar al contenido

Documentación

Cómo usar cada función, con sus atajos y comandos.

El comando mahzz

Dentro de MahzzTerm tenés el comando mahzz. No abre nada por su cuenta: le avisa a la interfaz qué hacer.

mahzz --resume      # elegir una sesión anterior y abrir sus pestañas
mahzz --resume 2    # abrir directo la segunda sesión más reciente
mahzz --agentes     # ver los agentes que están corriendo
mahzz --cambios     # revisar los cambios del repositorio
mahzz --help        # ayuda

Bloques de comandos

Cada comando queda agrupado con su salida, su duración y su código de error. Un bloque se puede copiar, repetir o buscar. Los hosts de ~/.ssh/config también tienen bloques dentro del servidor (bash).

El editor de comandos tiene colores, varios cursores, autocompletado y una barra de contexto con la carpeta, la rama de git y el tipo de proyecto.

Panel de agentes activos

Cuando tenés varios agentes en distintas pestañas, te muestra cuál está trabajando y cuál te espera. Se abre con el botón ✦, Ctrl+Shift+A o mahzz --agentes. Al hacer clic en una fila, te lleva a su pestaña.

EstadoCuándo
TrabajandoEl programa escribió algo en los últimos 3 segundos.
EsperandoPasaron más de 3 segundos sin salida.
Te necesitaEl programa tocó la campana de la terminal (BEL). Claude Code lo hace si tiene activada la notificación por campana.

Si un agente trabajó 10 segundos o más y termina mientras mirás otra cosa, llega una notificación de Windows y el punto de su pestaña se pone ámbar.

Qué cuenta como agente: claude, codex, gemini, aider, opencode, cursor-agent, copilot, goose, crush, qwen, amp y ollama. Un agente instalado con npm corre como node y no se detecta; Claude Code con el instalador nativo sí.

Revisión de cambios

Muestra qué tocó un agente (o vos) en el repositorio y te deja decidir archivo por archivo. Se abre con Ctrl+Shift+G o mahzz --cambios, y usa el repo de la carpeta del panel activo.

  • Clic en un archivo: muestra u oculta su diff.
  • Aceptar hace git add del archivo. Aceptar todo, de todos.
  • Revertir lo deja como en el último commit (si es nuevo, lo borra). Siempre pide confirmación.
LetraSignifica
MModificado
NNuevo
BBorrado
RRenombrado
✓Aceptado

Mientras está abierto se actualiza cada 3 segundos. Muestra hasta 1000 archivos y 4000 líneas por diff.

Sesiones y mahzz --resume

Cada ventana principal se guarda como una sesión: pestañas, divisiones con su proporción, carpetas, colores, nombres y qué programa corría. No se guarda la salida. Se conservan las 30 más recientes.

En el selector de mahzz --resume, Enter abre la sesión y Supr la borra de la lista. Si un panel tenía claude, queda escrito claude --continue, listo para confirmar con Enter.

Visor y editor de archivos

Un clic en un archivo del árbol lo abre en un panel lateral, que se agranda arrastrando su borde.

  • Código con colores, números de línea, búsqueda y plegado. Se guarda con Ctrl+S. Si un agente lo cambia en el disco, se recarga solo y te avisa si tenías cambios sin guardar.
  • HTML con vista web como Live Server: carga su CSS y su JS y se recarga al guardar. El servidor corre solo en 127.0.0.1.
  • Markdown renderizado, imágenes, video, audio, PDF, Excel/ODS/CSV como tabla y Word como documento.

En el árbol: F2 renombra, Supr manda a la papelera, Ctrl+X/C/V corta, copia y pega, y arrastrar mueve (con Ctrl, copia). Soltar un archivo sobre la terminal escribe su ruta.

Atajos

AtajoAcción
Ctrl+Shift+PPaleta de comandos
Ctrl+RHistorial
Ctrl+Shift+AAgentes activos
Ctrl+Shift+GRevisión de cambios
Ctrl+,Ajustes
Ctrl+SGuardar el archivo del visor

Todos se pueden cambiar en Ajustes → Atajos.

Datos y sincronización

Ajustes, historial, sesiones, temas, secretos y la sesión de Google viven en:

%LOCALAPPDATA%\com.mahzz.mahzzterm\datos

La sesión de Google y los secretos están cifrados con tu usuario de Windows: copiados a otra PC o a otra cuenta no se pueden leer. Para usar otra carpeta (pruebas o versión portable), definí la variable MAHZZTERM_DATOS.

La sincronización con Google Drive es opcional: guarda ajustes, temas, comandos guardados e historial en la carpeta privada de la app en tu Drive.