HakoHow-to Guides
How to Use the macOS App
Manage environments from the macOS menu bar.
Hako includes a macOS menu bar app for macOS 14+ on Apple Silicon.
Install
Download the DMG from the latest releases. Open the DMG and drag Hako to Applications. The app is signed and notarized.
Features
- Menu bar icon with dropdown showing all environments
- Start and stop services per environment
- View logs per service
- Open a shell per environment
- Grouped by repository with running status indicators
- Menu bar and optional Dock mode
- Automatic updates via Sparkle
How It Syncs
The app executes the hako CLI binary via Foundation.Process and parses JSON output from hako ls --all --json, hako ports --json, and hako status --json. Configuration is shared at ~/.config/hako/config.yml.
New CLI features that extend JSON output are picked up automatically without app changes.
Build from Source
cd macos/Hako && xcodebuild -scheme Hako -configuration Release buildRequires Swift 6, macOS 14+, Apple Silicon.
How to Use Portless URLs
Access environments via human-readable local URLs.
CLI Reference
Exhaustive reference for the hako command-line interface.
ops.origin: Masakiro Corp.