Getting Started
Download
Download the latest release from the GitHub Releases page. After installing, maiTerm checks for updates automatically and notifies you when a new version is available — update with a single click.
| Platform | Format |
|---|---|
| macOS | DMG |
| Windows | NSIS installer (.exe) |
| Linux | .deb package |
Prerequisites (Building from Source)
If you want to build maiTerm from source, you’ll need:
All platforms:
macOS:
- macOS 13+
- Xcode Command Line Tools (
xcode-select --install)
Windows:
- Windows 10/11
- Visual Studio Build Tools — select “Desktop development with C++” workload
- WebView2 (pre-installed on Windows 10/11)
Linux:
- WebKitGTK 4.1, GTK 3, libayatana-appindicator3
- See Tauri Linux prerequisites
First Launch
- Open maiTerm
- You’ll start with a default workspace and a single terminal tab
- The terminal spawns your default shell automatically
Quick Tips
- Cmd+T — new tab
- Cmd+D — split pane (duplicates current tab with full context)
- Cmd+Opt+N — new workspace
- Cmd+E — notes panel · Cmd+Shift+E — task panel
- Cmd+, — open preferences
- Cmd+/ — help and keyboard shortcuts
Setting Up Agent Integration
maiTerm integrates with Claude Code and OpenAI Codex, both enabled by default. When you run claude or codex in a terminal tab, maiTerm automatically:
- Exposes MCP/IDE tools to the agent
- Tracks live state through the agent’s hooks
- Captures the session ID and enables auto-resume
- Binds the session to the tab it’s running in
No configuration needed, and no registration step: the tab identifies itself on the wire and the session links itself when the agent starts, so a restart, a resume or a compaction all come back correctly bound with nothing typed. (/maiterm init still exists, but only as a repair tool — see acting as the right tab.)
To choose which agents maiTerm wires up — locally and over SSH — open Preferences → AI Agents. See Agent Integration for the full picture.
Your agent also shares a task list with you out of the box: it records what it’s working on, you edit the same rows in a panel on Cmd+Shift+E, and each side sees the other’s changes.