Skip to main content

macOS Installation

Complete guide for installing the CastellanAI Agent on macOS.

Prerequisites​

  • macOS 12 (Monterey) or later
  • Apple Silicon or Intel processor
  • Administrator access
  • Network access to Worker API

Download​

  1. Log in to the Customer Portal
  2. Navigate to Agents → Download
  3. Select macOS and download the .pkg installer

Installation​

Package Installer​

sudo installer -pkg CastellanAgent.pkg -target /

Homebrew (Coming Soon)​

brew tap castellanai/tap
brew install castellan-agent

Configuration​

Edit the configuration file:

sudo nano /Library/Application\ Support/CastellanAgent/appsettings.json
{
  "AgentSettings": {
    "CustomerId": "your-customer-id",
    "HubUrl": "https://api.castellanai.com/hubs/agent-communication"
  }
}

Start the Service​

The agent runs as a launchd service:

sudo launchctl load /Library/LaunchDaemons/com.castellanai.agent.plist

Verify Installation​

# Check service status
sudo launchctl list | grep castellan

# View logs
tail -f ~/Library/Logs/CastellanAgent/agent.log

Uninstallation​

# Stop and unload service
sudo launchctl unload /Library/LaunchDaemons/com.castellanai.agent.plist

# Remove files
sudo rm -rf /Library/Application\ Support/CastellanAgent
sudo rm /Library/LaunchDaemons/com.castellanai.agent.plist