Setup
Gunamaya on macOS
One universal build covers both Apple Silicon and Intel Macs.
Download and install
Gunamaya distributes macOS as a single universal .dmg — it contains native
binaries for both Apple Silicon (M-series) and Intel processors, so you don't
need to pick an architecture. Open the .dmg, then drag Gunamaya.app
into your Applications folder.
'Gunamaya' can't be opened because it is from an unidentified developer
If macOS Gatekeeper blocks the first launch, right-click (or Control-click) Gunamaya.app in Finder, choose Open, and confirm in the dialog that appears. You only need to do this once.
Launching from the terminal
Gunamaya can install a gunamaya command on your shell PATH so you can
open folders directly from Terminal or iTerm:
Open the Command Palette
Launch Gunamaya, then press Cmd + Shift + P.
Run the install command
Type Shell Command: Install 'gunamaya' command in PATH and select it.
Restart your terminal
Open a new terminal window or tab, then run:
gunamaya .from inside any project folder.
Apple Silicon notes
The Apple Silicon build runs natively — no Rosetta translation layer — which
means faster startup and lower memory use compared to running an Intel build
under emulation. If you've previously installed an Intel-only build under
Rosetta, replacing it with the current universal .dmg switches you to the
native path automatically; no separate download is needed.
Keeping Gunamaya up to date
Gunamaya checks for updates automatically and prompts you to restart when a
new version has finished downloading. You can also trigger a manual check
from the Command Palette with Check for Updates…, or disable automatic
checks entirely in Settings under update.mode.
Uninstalling
Quit Gunamaya, then drag Gunamaya.app from Applications to the Trash.
Your settings, extensions, and Gunamaya AI configuration live in
~/Library/Application Support/Gunamaya and ~/.gunamaya; remove those
directories too if you want a completely clean slate. See
Portable Mode & Uninstalling for the full list of
locations.