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 # helpCommand 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.
| Status | When |
|---|---|
| Working | The program printed something in the last 3 seconds. |
| Waiting | More than 3 seconds without output. |
| Needs you | The 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 addon the file. Accept all does it for every file. - Revert restores it to the last commit (new files are deleted). It always asks first.
| Letter | Meaning |
|---|---|
| M | Modified |
| N | New |
| B | Deleted |
| R | Renamed |
| ✓ | 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
| Shortcut | Action |
|---|---|
Ctrl+Shift+P | Command palette |
Ctrl+R | History |
Ctrl+Shift+A | Active agents |
Ctrl+Shift+G | Change review |
Ctrl+, | Settings |
Ctrl+S | Save 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.