Installation

Install Mallard via Homebrew, Scoop, or the curl installer — then link skills and verify.

Mallard ships as a single binary. Pick the install method for your platform, then run mallard update to symlink the skills, commands, and agents into your agent config.

macOS / Linux (Homebrew)

brew install educlopez/tap/mallard

Upgrade later with brew upgrade mallard.

Windows (Scoop)

scoop bucket add educlopez https://github.com/educlopez/scoop-bucket
scoop install mallard

Upgrade later with scoop update mallard.

macOS / Linux (curl installer)

curl -fsSL https://raw.githubusercontent.com/educlopez/mallard/main/install.sh | bash

Drops the binary into ~/.local/bin/mallard (override with MALLARD_INSTALL_DIR=/usr/local/bin). Make sure ~/.local/bin is on your PATH.

Pin a specific version:

MALLARD_VERSION=v0.2.0 curl -fsSL https://raw.githubusercontent.com/educlopez/mallard/main/install.sh | bash

Grab the latest zip from Releases (mallard_<version>_windows_amd64.zip or _arm64.zip), extract it, and move mallard.exe somewhere on your PATH. Or use WSL / Git Bash with the curl installer above.

From source

git clone git@github.com:educlopez/mallard.git
cd mallard
go build -o mallard .
./mallard update

After install

mallard update    # install Claude/Codex/OpenCode skills + commands
mallard doctor    # verify installation
mallard           # launch interactive TUI

The binary auto-detects installed agents (claude, codex, opencode) and symlinks the appropriate skills/commands directories. Agents are Claude-only.

Update

Re-run the curl-pipe installer to upgrade the binary, then re-link skills:

curl -fsSL https://raw.githubusercontent.com/educlopez/mallard/main/install.sh | bash
mallard update             # re-link skills/commands (backs up conflicts)

Windows: download the latest zip from Releases and replace mallard.exe.

mallard update --list-backups and mallard update --restore <ts> recover prior state if anything went sideways.