Installation

Install SkillSea as a standalone binary on macOS, Linux, or Windows.

Quick Install

Run this one-liner on macOS or Linux to download and install SkillSea:

curl -fsSL https://probecodex.com/downloads/skillsea/install.sh | bash

What this does: Detects your OS and architecture, downloads the correct binary, installs it, and adds it to your PATH. On macOS it installs a signed .pkg to /usr/local/bin/. On Linux it installs to ~/.skillsea/bin/.

macOS

SkillSea ships as a signed and notarized .pkg installer for both Apple Silicon and Intel Macs.

Option A: Install Script (Recommended)

curl -fsSL https://probecodex.com/downloads/skillsea/install.sh | bash

Detects ARM64 or x86_64 automatically. May prompt for your password to run the .pkg installer.

Option B: Manual Download

Architecture	File
Apple Silicon (M1/M2/M3/M4)	skillsea-macos-arm64.pkg
Intel	skillsea-macos-x64.pkg

Download from https://probecodex.com/downloads/skillsea/, then double-click the .pkg or run:

sudo installer -pkg skillsea-macos-arm64.pkg -target /

Linux

Option A: Install Script (Recommended)

curl -fsSL https://probecodex.com/downloads/skillsea/install.sh | bash

Installs to ~/.skillsea/bin/ and adds it to your PATH via .zshrc or .bashrc.

Option B: Manual Install

# Download

curl -fsSL -o skillsea-linux-x64.tar.gz https://probecodex.com/downloads/skillsea/skillsea-linux-x64.tar.gz

# Extract

tar -xzf skillsea-linux-x64.tar.gz

# Install

mkdir -p ~/.skillsea/bin

cp -r skillsea/* ~/.skillsea/bin/

chmod +x ~/.skillsea/bin/skillsea

# Add to PATH

echo 'export PATH="$HOME/.skillsea/bin:$PATH"' >> ~/.bashrc

source ~/.bashrc

Windows

Download the Windows zip archive and extract it:

Download

Download skillsea-win-x64.zip from https://probecodex.com/downloads/skillsea/

Extract

Right-click the .zip and select "Extract All" to a folder like C:\skillsea

Add to PATH

Add the folder to your system PATH: Settings → System → About → Advanced system settings → Environment Variables → Edit Path

Verify Installation

skillsea --version

# Output: skillsea 0.5.3a1

If the command is not found, restart your terminal or run source ~/.zshrc (macOS) / source ~/.bashrc (Linux).

System Requirements

macOS

macOS 12 (Monterey) or later
Apple Silicon (ARM64) or Intel (x64)
~50 MB disk space

Linux

x86_64 architecture
glibc 2.31+ (Ubuntu 20.04+, Debian 11+)
~50 MB disk space

Windows

Windows 10 or 11 (64-bit)
x64 architecture
~50 MB disk space

Developer Setup (From Source)

For contributors or if you want to run from source with Python:

# Clone the repository

git clone https://github.com/droidtech42/skillsea-mcp.git

cd skillsea-mcp/servers/mcp-neo4j-cypher

# Create virtual environment and install

uv venv && source .venv/bin/activate

uv sync

# Run the server

uv run mcp-neo4j-cypher --transport stdio

Requires Python 3.10+ and the uv package manager.

Uninstall

macOS

sudo rm /usr/local/bin/skillsea

Linux

rm -rf ~/.skillsea/bin

Config & Cache

# Remove configuration and cache

rm -rf ~/.skillsea

Next Steps

Getting Started →CLI Reference →← Back to Docs