Quick install

The one-line installer downloads and places the pillbox binary on your PATH. The MCP server and agent skill must be installed afterwards — they are not included in the one-liner.

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/Kevinsillo/pillbox/main/install.sh | bash

The installer:

1. Detects your platform (Linux/macOS, x86_64/aarch64)
2. Downloads the pillbox binary from GitHub Releases
3. Installs it to ~/.local/bin (Linux) or /usr/local/bin (macOS)

Windows

Run in PowerShell:

irm https://raw.githubusercontent.com/Kevinsillo/pillbox/main/install.ps1 | iex

The installer:

1. Detects your architecture (x86_64/aarch64)
2. Downloads the pillbox binary from GitHub Releases
3. Installs it to %LOCALAPPDATA%\Programs\pillbox
4. Adds the install directory to your user PATH (no Administrator needed)

You may need to open a new terminal for the updated PATH to take effect.

Caution

The installer itself runs without elevation, but pillbox serve install and pillbox serve uninstall require an elevated (Administrator) PowerShell. They register a Windows service and edit the hosts file.

After installing the binary

1. Install the MCP server:

   pillbox mcp install

   Requires Node.js ≥ 18. Downloads the server bundle and registers it with your AI provider.

2. Install the Pillbox skill:

   pillbox skill install

   Installs the Pillbox skill to your provider’s global config folder (~/.claude/skills/pillbox/ for Claude Code, ~/.config/opencode/skill/pillbox/ for OpenCode). The installer will also ask whether you want to install the SDD skill, agents, and commands.

3. Install and start the web interface:

   pillbox serve install
   pillbox serve start

   pillbox serve install registers the HTTP server as a system service and enables autostart on boot. Run pillbox serve start once to start it immediately — on subsequent boots it starts automatically. The UI is then available at http://pillbox.local:4242.

   See Web interface for more.

Options

Linux / macOS

Install a specific version:

curl -fsSL https://raw.githubusercontent.com/Kevinsillo/pillbox/main/install.sh | bash -s -- --version 0.15.3

Custom install directory:

curl -fsSL https://raw.githubusercontent.com/Kevinsillo/pillbox/main/install.sh | bash -s -- --install-dir /usr/local/bin

Windows

Install a specific version or use a custom directory with environment variables:

$env:PILLBOX_VERSION = '0.15.3'
$env:PILLBOX_INSTALL_DIR = 'C:\Tools\pillbox'
irm https://raw.githubusercontent.com/Kevinsillo/pillbox/main/install.ps1 | iex