AiyuTerm is a native macOS terminal workspace app for developers who work across repositories, worktrees, branches, and split panes. It supports local shell, SSH, tmux sessions, and AI agent-backed terminal sessions with real-time status badges.
- Multi-repo sidebar -- Keep multiple repositories and worktrees in one sidebar, switch between them instantly
- Persistent layout -- Reopen the same pane layout when you come back to a repo; layouts are saved per worktree
- Split panes -- Split terminals horizontally or vertically, zoom any pane to full screen
- Multiple session types -- Mix local shell, SSH, and agent-backed terminal sessions in the same workspace
- Tmux integration -- Sidebar panel for tmux session management (attach, create, rename, kill)
- Agent status badges -- Real-time permission and task completion notifications for Claude Code
- Command palette -- Quick access to all actions via keyboard
- Customizable shortcuts -- Rebind every keyboard shortcut in Settings
- Native macOS app -- Built with AppKit + SwiftUI, powered by the Ghostty terminal engine
Download the latest signed .dmg from GitHub Releases:
https://github.com/aiyu-ai/AiyuTerm/releases/latest
Open AiyuTerm and drag a folder into the sidebar, or use the "+" button to add local repositories.
Select a repository or worktree in the sidebar, then press Cmd+T to open a new terminal tab.
Cmd+D-- Split rightCmd+Shift+D-- Split downCmd+Option+Arrow-- Move focus between panesCmd+Enter-- Toggle zoom on the active pane
Click another worktree in the sidebar. AiyuTerm restores the last pane layout you used for that worktree automatically.
Press Cmd+P to open the command palette for quick access to all actions.
All shortcuts are customizable in Settings (Cmd+,).
| Action | Shortcut |
|---|---|
| New tab | Cmd+T |
| Close tab | Cmd+W |
| Next tab | Ctrl+Tab |
| Previous tab | Ctrl+Shift+Tab |
| Select tab 1-9 | Cmd+1 ... Cmd+9 |
| Action | Shortcut |
|---|---|
| Split right | Cmd+D |
| Split down | Cmd+Shift+D |
| Duplicate pane | Cmd+Option+D |
| Focus left/right/up/down | Cmd+Option+Arrow |
| Toggle pane zoom | Cmd+Enter |
| Close pane | Cmd+Option+W |
| Action | Shortcut |
|---|---|
| Command palette | Cmd+P |
| Toggle sidebar | Cmd+B |
| Toggle overview | Cmd+Shift+O |
| Find | Cmd+F |
| Settings | Cmd+, |
| Refresh workspace | Cmd+R |
| Refresh all repos | Cmd+Shift+R |
| Full screen | Ctrl+Cmd+F |
AiyuTerm shows real-time status on sidebar icons when Claude Code needs attention:
| Status | Badge | Trigger |
|---|---|---|
| Permission needed | Red pulse | Claude Code waiting for user approval |
| Task completed | Green checkmark | Claude Code finished a task |
| Error | Red static | Claude Code encountered an error |
Powered by Claude Code hooks. See docs/agent-status-badges.md for setup instructions.
AiyuTerm provides a sidebar panel for managing tmux sessions within your workspace:
- Attach to existing tmux sessions
- Create new named sessions
- Rename or kill sessions from the sidebar
- Sessions are grouped by workspace
Requires tmux installed (brew install tmux).
AiyuTerm stores workspace data and settings as JSON files:
- Default:
~/.aiyuterm/ - Debug builds:
~/.aiyuterm-debug/
No cloud sync. All data stays local on your machine.
- macOS 14.6 or later
- Universal build: Apple Silicon and Intel Macs
Development setup, build commands, testing, and release docs: DEVELOP.md.
- Liney by wuwenrui -- the original open-source terminal workspace app this project is forked from
- Ghostty -- the terminal engine powering AiyuTerm
- Sparkle -- auto-update framework
Released under the Apache License 2.0. See LICENSE.