About Mini-Term
An AI terminal management tool supporting multi-project, multi-terminal layout management
Features
Terminal Core
- Multi-tab management — Independent tabs per project, drag-to-sort, status icons at a glance
- Recursive splitting — Horizontal/vertical nested splits, Allotment drag-to-adjust ratios
- High-performance rendering — xterm.js v6 + WebGL acceleration, automatic Canvas fallback
- 100K-line scrollback — Intercepts CSI 3J (ED3) commands, preserves scrollback history when Claude/Codex TUIs clear screen
- Terminal caching — Switching tabs/splits without rebuilding xterm instances, existing content preserved
- Copy & paste — Ctrl+Shift+C / Ctrl+Shift+V shortcuts + right-click menu, "Copy" auto-grayed when no selection; Windows large multi-line paste auto-chunked to prevent ConPTY line loss
- Long text paste — Clipboard text ≥10 lines or ≥2000 chars auto-saved as temp .txt and pastes quoted file path, avoiding AI tool performance and paste bracket issues with ultra-long content
- Image paste — Auto-detects screenshots in clipboard, saves as temp PNG via Win32 API and pastes quoted path, compatible with non-standard formats like PinPix
- File drag-drop — Files dragged to terminal auto-insert quoted absolute paths, compatible with spaces-in-path
- Multi-Shell config — Windows (cmd / powershell / pwsh), macOS (zsh / bash), Linux (bash / sh), freely add/remove
AI Process Awareness
- Real-time status detection — 500ms polling child process names, auto-identifies Claude/Codex, displays idle/working/error states
- Status aggregation — Panel → Tab → Project layered aggregation, priority: error > ai-working > ai-idle > idle
- Completion alert trio — Triggers immediately when AI task goes working → idle:
- Bottom-right Toast desktop notification (inactive projects only, deduplicated per project)
- Project list DONE badge, click to clear
- Taskbar flash (Windows) / Dock bounce (macOS), only when window unfocused
- Three toggles independently configurable
- Session entry/exit detection — Command echo identifies AI entry; double Ctrl+C / Ctrl+D or exit/quit/:quit/logout identifies exit
- Session history — Reads local Claude/Codex session history, right-click copy recovery command for quick resumption
- AI task markers — Auto-logs xterm on each Enter press in AI session, tab top-right ⚑ button drops down history submission list, click or Ctrl+Shift+↑/↓ to jump between markers, target line briefly highlighted
Project Management
- Project list — Left sidebar manages multiple project directories, one-click workspace switch, auto-restores last active project on restart
- Drag-to-add projects — Drag folders from Explorer to project list for quick add, auto-identifies files/folders/duplicates with visual feedback
- Nested groups — Up to 3-level project grouping, drag-to-sort, collapse/expand
- File tree — Integrated directory browser, nested .gitignore grayed out (per-subdirectory ignore rules and !pattern whitelists respected, consistent with git behavior), notify file watcher real-time refresh
- File operations — New file/folder, rename, view content in file tree (binary and oversized file friendly prompts)
- VS Code quick open — File tree top-right button opens current project with configured VS Code executable, path customizable in "Settings → System Settings → External Editor"
Git Integration
- File status — Git status colors in file tree (modified/added/deleted/conflict)
- Change Diff — Detailed Diff for working directory changes, Hunk line-level parsing, side-by-side/inline dual view
- Commit history — Browse repository commit log, cursor pagination (default 30 items)
- Commit Diff — View file changes for any commit, per-file switching
- Branch info — Local/remote branch list
- Source control panel — VS Code-style Changes panel, Staged/Changes/Untrackedg grouping, single-file and bulk stage/unstage/discard, Ctrl+Enter quick commit, list/tree view toggle
- Pull/Push — In-line repository buttons for one-click remote sync, refresh button reloads commit history and branch info
- Multi-repo discovery — Auto-scans all Git repositories under project directory (recursive 5 levels, skips node_modules, etc.)
Appearance & Configuration
- Activity Bar sidebar — Leftmost permanent 40px icon bar, Projects/Sessions/Files/Git panel toggles, independent show/hide control, active state blue vertical bar indicator, state persistence
- Three theme modes — Auto (follow system)/Light/Dark, dark based on Warm Carbon warm charcoal tones, custom CSS variable system
- Independent font adjustment — UI and terminal font sizes separately adjustable (10-20px), terminal optional UI theme following
- Layout persistence — Split ratios, tabs, window size/position auto-saved and restored on restart (tauri-plugin-window-state)
- Close confirmation — Pre-close confirmation dialog, flushes all project layouts to prevent accidental operations
- Version check — Fetches GitHub Release on startup, title bar shows new version notification
- Settings center — Unified SettingsModal manages themes, fonts, Shell, AI notifications and all other toggles
