Skip to content

Documentation

How to use each feature, with its shortcuts and commands.

The mahzz command

Inside MahzzTerm you get the mahzz command. It doesn't open anything by itself: it tells the interface what to do.

mahzz --resume      # pick a previous session and reopen its tabs
mahzz --resume 2    # open the second most recent session directly
mahzz --agentes     # see the agents that are running
mahzz --cambios     # review the repository changes
mahzz --help        # help

Command blocks

Every command is grouped with its output, duration and exit code. You can copy, rerun or search a block. Hosts from ~/.ssh/config get blocks inside the server too (bash).

The command editor has syntax colors, multiple cursors, autocomplete and a context bar with the folder, git branch and project type.

Active agents panel

When you have several agents in different tabs, it shows which one is working and which one is waiting for you. Open it with the ✦ button, Ctrl+Shift+A or mahzz --agentes. Click a row to jump to its tab.

StatusWhen
WorkingThe program printed something in the last 3 seconds.
WaitingMore than 3 seconds without output.
Needs youThe program rang the terminal bell (BEL). Claude Code does this if bell notifications are enabled.

If an agent worked for 10 seconds or more and finishes while you're looking elsewhere, you get a Windows notification and its tab dot turns amber.

What counts as an agent: claude, codex, gemini, aider, opencode, cursor-agent, copilot, goose, crush, qwen, amp and ollama. An agent installed with npm runs as node and isn't detected; Claude Code with the native installer is.

Change review

Shows what an agent (or you) touched in the repository and lets you decide file by file. Open it with Ctrl+Shift+G or mahzz --cambios; it uses the repo of the active pane's folder.

  • Click a file to show or hide its diff.
  • Accept runs git add on the file. Accept all does it for every file.
  • Revert restores it to the last commit (new files are deleted). It always asks first.
LetterMeaning
MModified
NNew
BDeleted
RRenamed
✓Accepted

While open, it refreshes every 3 seconds. It shows up to 1000 files and 4000 lines per diff.

Sessions and mahzz --resume

Each main window is saved as a session: tabs, splits with their ratio, folders, colors, names and which program was running. Output isn't saved. The 30 most recent are kept.

In the mahzz --resume picker, Enter opens a session and Del removes it from the list. If a pane was running claude, claude --continue is typed in, ready to confirm with Enter.

File viewer and editor

Click a file in the tree and it opens in a side panel, which you can widen by dragging its edge.

  • Code with highlighting, line numbers, search and folding. Save with Ctrl+S. If an agent changes it on disk, it reloads and warns you if you had unsaved changes.
  • HTML with a Live Server–style web view: it loads its CSS and JS and reloads on save. The server only runs on 127.0.0.1.
  • Rendered Markdown, images, video, audio, PDF, Excel/ODS/CSV as tables and Word as a document.

In the tree: F2 renames, Del sends to the Recycle Bin, Ctrl+X/C/V cuts, copies and pastes, and dragging moves (with Ctrl, copies). Dropping a file onto the terminal types its path.

Shortcuts

ShortcutAction
Ctrl+Shift+PCommand palette
Ctrl+RHistory
Ctrl+Shift+AActive agents
Ctrl+Shift+GChange review
Ctrl+,Settings
Ctrl+SSave the file in the viewer

All of them can be changed in Settings → Shortcuts.

Data and sync

Settings, history, sessions, themes, secrets and the Google session live in:

%LOCALAPPDATA%\com.mahzz.mahzzterm\datos

The Google session and secrets are encrypted with your Windows user: copied to another PC or account, they can't be read. To use another folder (testing or a portable build), set the MAHZZTERM_DATOS variable.

Google Drive sync is optional: it stores settings, themes, saved commands and history in the app's private folder in your Drive.