Getting Started with Iruka
Iruka is a native macOS app that brings together a powerful terminal emulator, SSH/SCP manager, built-in file manager, and Git integration — all in a clean, fast interface built for developers.
What You Can Do
- Terminal — Full xterm-compatible terminal with a session per tab and theme customisation
- SSH & SCP — Save and connect to remote servers; browse and transfer files over SCP
- File Manager — Dual-pane file browser with preview, drag-and-drop, and quick-look support
- Git Integration — Read back everything a coding agent just changed, file by file, and turn it into sensible commits
- Search — Find files by name or content, locally or in mounted remote folders
- Drop Stack — Park files on a shelf, navigate anywhere, then copy or move the whole pile
- Batch Rename — Find and replace (with regular expressions), prefixes, suffixes and numbering in one pass
- Finder Integration — "Open in Iruka" in Finder's own right-click menu and toolbar
System Requirements
- macOS 14 Sonoma or later
- Apple Silicon or Intel Mac
Quick Setup
- Download Iruka and drag it to your Applications folder — or install via Homebrew with
brew install --cask dorienh/iruka/iruka(see Installation) - Open Iruka and grant the permissions it requests (Terminal, Files, Network)
- Activate your license if you have purchased a license key
- (Optional) Connect your first SSH server from the SSH tab
That's it — no configuration files or package managers required.
Next Steps
- Installation — detailed install and permission guide
- License & Activation — where to find your key and how to activate
- Terminal — shell setup, fonts, themes, and shortcuts
- SSH & SCP — adding servers and transferring files
- Git Integration — reviewing an agent's work, staging it, and committing it
- Drop Stack — parking files while you navigate somewhere else
- Finder Integration — opening a folder in Iruka straight from Finder
- Batch Rename — renaming many files at once
- Keyboard Shortcuts — the complete shortcut reference
- Troubleshooting — common issues and fixes
Support & Feature Requests
Everything goes through GitHub:
- Issues — support, bug reports, and feature requests
- Discussions — general questions, ideas, and show & tell