Installation

brew install --cask crawlio-app/tap/crawlio

This installs Crawlio.app to /Applications and creates two symlinks:

• crawlio: CLI tool
• crawlio-mcp: MCP server

brew install crawlio-app/tap/crawlio

Installs the standalone crawlio binary. Requires Crawlio.app to be running for crawl operations (the CLI communicates with the app via Unix Domain Socket).

brew install crawlio-app/tap/crawlio-mcp

Installs the standalone crawlio-mcp binary. Useful for headless setups where you only need MCP integration.

After installing, run the init wizard to configure your AI clients:

crawlio-mcp init

Zero-install MCP setup. No Homebrew or DMG needed.

npx crawlio-mcp init    # Configure AI clients
npx crawlio-mcp         # Run as MCP server (stdio)
npx crawlio-mcp --full  # All 49 tools (vs 6 code-mode)

The npm package auto-downloads the native binary on first run. It checks these locations in order:

1. $CRAWLIO_MCP_BINARY (environment variable override)
2. ~/.crawlio/bin/CrawlioMCP (npm auto-download cache)
3. /Applications/Crawlio.app/Contents/Helpers/CrawlioMCP
4. /opt/homebrew/bin/crawlio-mcp (Homebrew)
5. Auto-download from GitHub Releases (fallback)

Requires Xcode 16+ and Swift 6.

git clone https://github.com/Crawlio-app/Crawlio-app.git
cd Crawlio-app
swift build

Build individual products:

swift build --product Crawlio      # Desktop app
swift build --product CrawlioMCP   # MCP server
swift build --product CrawlioCLI   # CLI tool

Binaries are output to .build/debug/.