Reference
Agent downloads
Direct links to every thespider-agent release file, with manual checksum verification
These are the files the installer fetches. Most people don't need them. The installer finds the right binary, checks its SHA-256, and puts it on your PATH. Here is the order to try:
- Point your coding agent at
startup.md, as described in AI setup. - Run the install script.
- Download a file from this page by hand.
Latest release
| Platform ID | Operating system | File |
|---|---|---|
linux-x86_64 | Linux x86_64 (static musl) | thespider-agent-linux-x86_64 |
linux-aarch64 | Linux aarch64 (static musl) | thespider-agent-linux-aarch64 |
darwin-x86_64 | macOS Intel | thespider-agent-darwin-x86_64 |
darwin-arm64 | macOS Apple silicon | thespider-agent-darwin-arm64 |
windows-x86_64 | Windows x86_64 (git-bash) | thespider-agent-windows-x86_64.exe |
| File | Contents |
|---|---|
SHA256SUMS | One <sha256> <file name> line per binary |
latest.json | The current version, its tag, and each binary's path, SHA-256, and size |
A specific version
Every release also lives under its tag, and those files never change:
https://thespider.xyz/downloads/agent/v{X.Y.Z}/thespider-agent-{platform}
https://thespider.xyz/downloads/agent/v{X.Y.Z}/thespider-agent-windows-x86_64.exe
https://thespider.xyz/downloads/agent/v{X.Y.Z}/SHA256SUMS
https://thespider.xyz/downloads/agent/v{X.Y.Z}/manifest.json
There is no index of past versions. latest.json gives the current tag. If you already have the agent, thespider-agent update --version vX.Y.Z installs a pinned version and checks it for you.
Verify and install by hand
Download the binary and SHA256SUMS from the same directory, latest/ or one tag. Then check the hash:
name=thespider-agent-linux-x86_64 # your platform's file name
base=https://thespider.xyz/downloads/agent/latest
curl -fsSL --proto '=https' "$base/$name?source=docs" -o "$name"
curl -fsSL --proto '=https' "$base/SHA256SUMS" -o SHA256SUMS
grep " $name\$" SHA256SUMS | sha256sum -c - # macOS: shasum -a 256 -c -
chmod +x "$name"
mv "$name" ~/.local/bin/thespider-agent
thespider-agent --version
macOS builds are ad-hoc signed, not notarized. If a browser downloads the file, Gatekeeper quarantines it. Clear the quarantine with
xattr -d com.apple.quarantine thespider-agent after you verify the checksum, or download with curl, which does not set quarantine. The Windows .exe is unsigned, so SmartScreen may prompt on first run.The endpoint behavior (caching, rate limits, the X-Checksum-SHA256 header) is in the API reference.