Install on macOS

The Connector supports macOS 12 (Monterey) or later on both Intel and Apple Silicon Macs. Choose whichever method feels most natural.

macOS 12+
Intel & Apple Silicon
3 install options
OPTION 1

Install script

One line, auto-detects your architecture, installs to /usr/local/bin/kuali (prompts for your password if needed):

$

curl -fsSL https://connector.kuali.co/install.sh | sh

Install a specific version (prereleases or older builds)

Set KUALI_VERSION to any published release tag — with or without the v prefix:

$

curl -fsSL https://connector.kuali.co/install.sh | KUALI_VERSION=1.0.0-rc14 sh

Without KUALI_VERSION, the script installs the latest stable release.

OPTION 2

Homebrew

If you already use Homebrew:

$

brew update && brew install kualico/tap/kuali

Upgrade later with brew upgrade kuali, or let the Connector update itself with kuali update install.

OPTION 3

Direct download

1

Open the latest release.

2

Download kuali-darwin-arm64 for Apple Silicon (M1/M2/M3/M4) or kuali-darwin-amd64 for Intel Macs. Not sure which you have? Apple menu → About This Mac → look at the "Chip" line.

3

In Terminal:

$

chmod +x ~/Downloads/kuali-darwin-*

$

sudo mv ~/Downloads/kuali-darwin-* /usr/local/bin/kuali

FIRST-LAUNCH APPROVAL

If macOS blocks the binary

macOS may block the binary the first time you run it because it wasn't downloaded through the App Store.

"kuali cannot be opened because the developer cannot be verified"

Open System Settings → Privacy & Security, scroll to the Security section, and click Allow Anyway next to the Connector entry. Then run kuali version again and click Open in the confirmation dialog. Or, from the terminal, clear the quarantine flag in one step:

$

xattr -d com.apple.quarantine $(which kuali)

VERIFY

Check it worked

$

kuali version

kuali 1.0.0-rc6 (commit …, built …)

You should see something like kuali 1.0.0-rc6 (commit …, built …).

If not, open

Troubleshooting ->
UNINSTALL

Clean removal

HomebrewScript or direct download

$

brew uninstall kuali

$

brew untap kualico/tap

$

sudo rm /usr/local/bin/kuali

$

rm -rf ~/.kuali

The ~/.kuali directory holds your config file and (if you used a plaintext credentials file) saved profiles. If you stored your API key in the keychain, also remove it with security delete-generic-password -s kuali-cli (repeat for each profile name).

Last updated: September 21, 2026

ON THIS PAGE

Option 1: Install scriptOption 2: HomebrewOption 3: Direct downloadFirst-launch approvalVerifyUninstall
<- Installation overview

Next: connect it

Once kuali version works, head to Getting started to connect your instance and AI assistant.

Getting started ->

Where to next

Prompt library

Ready-to-use prompts for curriculum, research, build apps, imports, workflow analysis, and reporting.

Browse prompts →
Client-specific guides

Tips for Claude Desktop, Claude Code, Codex, Gemini, Copilot, and VS Code.

AI assistants →
Use it as a CLI

Skip the chat — every capability is also a plain kuali command, ready for scripts and CI.

Command reference →