Detailed installation instructions for Natilius.

Installation Methods

Option 1: Homebrew (Recommended)

brew install vincentkoc/tap/natilius

This is the cleanest method—Homebrew manages updates and uninstallation.

Option 2: Installer Script

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/vincentkoc/natilius/main/install.sh)"

The installer:

• Clones Natilius to ~/.natilius
• Adds natilius command to /usr/local/bin
• Installs shell completions (bash/zsh)
• Creates default config at ~/.natiliusrc

Option 3: Manual Installation

git clone https://github.com/vincentkoc/natilius.git ~/.natilius
cd ~/.natilius
./install.sh

Verify Installation

# Check natilius is available
which natilius

# Show version
natilius version

# Run diagnostics
natilius doctor

Uninstallation

brew uninstall natilius

~/.natilius/uninstall.sh

curl -fsSL https://raw.githubusercontent.com/vincentkoc/natilius/main/uninstall.sh | bash

Updating

brew upgrade natilius

cd ~/.natilius && git pull

Troubleshooting Installation

"Command not found: natilius"

The command isn't in your PATH:

# Restart your shell
exec $SHELL

# Or add to PATH manually
export PATH="/usr/local/bin:$PATH"

"Permission denied"

The installer can't write to /usr/local/bin:

sudo chown -R $(whoami) /usr/local/bin

Homebrew not found (Apple Silicon)

On M1/M2/M3 Macs, Homebrew installs to /opt/homebrew:

# Add to ~/.zshrc
eval "$(/opt/homebrew/bin/brew shellenv)"

# Reload
source ~/.zshrc