Install Sigil CLI on macOS and Linux
Sigil is distributed through public release artifacts. The hosted installer is a small bootstrap script that downloads the latest release installer from GitHub and runs it on your machine or CI runner.
Supported platforms
Section titled “Supported platforms”| Platform | Status | Notes |
|---|---|---|
| macOS | Supported | Apple Silicon and Intel builds are published when available. |
| Linux | Supported | x86_64 builds are published when available. |
| Windows | Not documented yet | Use WSL2 for now, or email [email protected] with your target workflow. |
Shell installer
Section titled “Shell installer”curl -fsSL https://runsigil.com/install.sh | shThe script at https://runsigil.com/install.sh delegates to the latest public installer published at:
https://github.com/bobisme/sigil-releases/releases/latestPass installer flags after sh -s --:
curl -fsSL https://runsigil.com/install.sh | sh -s -- --no-modify-pathUse --no-modify-path when you want the installer to avoid editing shell profile PATH entries.
Homebrew
Section titled “Homebrew”brew install bobisme/tap/sigilPin a release
Section titled “Pin a release”For reproducible CI, install from a specific GitHub release instead of the moving latest URL. Replace v0.23.0 with the version you want:
curl -fsSL https://github.com/bobisme/sigil-releases/releases/download/v0.23.0/sigil-installer.sh | shVerify release artifacts
Section titled “Verify release artifacts”Release archives and checksums are published on GitHub:
https://github.com/bobisme/sigil-releases/releases/latestDownload the archive and checksum for your platform, then compare the published checksum with your local file:
shasum -a 256 sigil-*.tar.*If a release includes signature or provenance files, verify those before using Sigil in a protected CI path. For security or verification questions, email [email protected].
Confirm install
Section titled “Confirm install”sigil --versionsigil --helpIf your shell cannot find sigil, restart the shell or add Cargo’s bin directory to your PATH:
export PATH="$HOME/.cargo/bin:$PATH"Uninstall
Section titled “Uninstall”If installed into Cargo’s bin directory, remove the binary:
rm -f "$HOME/.cargo/bin/sigil"If installed through Homebrew:
brew uninstall sigilRemove any PATH entries the installer added only after confirming no other tools need the same directory.
Troubleshooting
Section titled “Troubleshooting”| Symptom | Check |
|---|---|
curl: command not found | Install curl, or download the release installer with another tool. |
sigil: command not found | Check ~/.cargo/bin in PATH, then restart the shell. |
| Permission denied in CI | Install into a writable directory, or run the installer before switching users. |
| Unsupported platform | Use WSL2 for Windows, or request platform support at [email protected]. |
| Need an exact artifact | Use the GitHub release page and pin the version in CI. |
Next step
Section titled “Next step”Run the quickstart to initialize a service, execute a first evaluation, and emit an ALLOW, REVIEW, or BLOCK decision.