Install on Linux

The Connector supports any modern 64-bit Linux distribution (Ubuntu, Debian, Fedora, RHEL, Rocky, Arch, Alpine, …) on x86_64 or arm64.

Any modern distro
x86_64 & arm64
No-sudo option
OPTION 1

Install script

$

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

Auto-detects your architecture and installs to /usr/local/bin/kuali. If /usr/local/bin isn't writable by your user, it uses sudo.

OPTION 2

Homebrew on Linux

$

brew update && brew install kualico/tap/kuali

OPTION 3

Direct download — no sudo

$

ARCH=$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')

$

curl -fsSL -o ~/.local/bin/kuali \

$

"https://github.com/kualico/kuali-connector/releases/latest/download/kuali-linux-${ARCH}"

$

chmod +x ~/.local/bin/kuali

Make sure ~/.local/bin is on your PATH — add export PATH="$HOME/.local/bin:$PATH" to ~/.bashrc or ~/.zshrc if it isn't, then reload your shell.

VERIFY

Check it worked

$

kuali version

KEYCHAIN

Keychain on Linux

The Connector uses the libsecret keychain (GNOME Keyring, KeePassXC, KDE Wallet) via D-Bus. On desktop Linux this Just Works. On headless servers it falls back to ~/.kuali/credentials (mode 0600), or supply credentials via KUALI_API_KEY / KUALI_<PROFILE>_API_KEY environment variables.

UNINSTALL

Clean removal

Installed to /usr/local
Installed to ~/.local
Homebrew

$

sudo rm /usr/local/bin/kuali

$

rm -rf ~/.kuali

Keychain entries can be removed with your desktop's secret-management tool or secret-tool clear service kuali-cli account <profile>.

Headless server?

When the libsecret keychain isn't available, the Connector falls back to ~/.kuali/credentials or per-profile env vars.

Skip to Installation ->

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 →