FetchBeta

Download Fetch for your computer

Fetch runs in your browser, and most people never need to install anything. fetch is an optional program for one situation: reaching things only your own computer can reach, like localhost, your company network, or a database. Browsers can't do that, and Fetch's cloud deliberately can't either (it only reaches the public internet, over HTTP and GraphQL).

Install

In Terminal:

curl -fsSL https://fetch.nightroll.app/install.sh | sh

It picks the right build, checks its SHA-256 checksum and installs fetch into~/.local/bin (set FETCH_INSTALL_DIR to choose another folder). Read it first if you like: install.sh.

Or download a file

The builds for the current release appear here.

What fetch is for

One program with several jobs. Use any of them, or none: everything else in Fetch works without it.

1. The Fetch Agent: send requests from your computer

fetch agent runs in the background and lets the Fetch web app send requests from your machine, so you can reach:

  • localhost and 127.0.0.1: the API you're building right now
  • your LAN, VPN and other private networks (internal services, staging behind a firewall)
  • APIs that need client certificates (mTLS) or a corporate proxy, and HTTP/3
  • Unix sockets, such as Docker's API (macOS and Linux)
  • databases: Postgres, MySQL and SQLite queries
  • MCP servers that run as local programs (stdio), to inspect and test them
  • AI providers that block browser calls, for the assistant and LLM requests with your own key

It also keeps local vault secrets in your OS keychain (they never leave your device), and runsscripts and protocols the cloud doesn't (gRPC, WebSocket, MQTT, SSE). (Source control doesn't need it: the app pulls and pushes to GitHub itself once you connect GitHub.)

Why it's needed: browsers block requests to other sites unless those sites allow it (CORS), and Fetch's cloud only reaches the public internet. Those protections stay on; the agent is the safe way around them on your own machine.

2. The CI runner: run collections anywhere

fetch run runs a collection with its scripts and tests in a terminal or a CI pipeline (GitHub Actions, GitLab, Jenkins…) and exits with an error when a test fails. It reads Postman (v2.0, v2.1, v3) and Fetch YAML files, takes CSV/JSON data files, writes JUnit, JSON, HTML and CTRF reports, and accepts newman's flags.

fetch run collection.json -e staging.json -d users.csv -r cli,junit --out reports

3. AI tools: use the MCP server, not this program

AI agents (Claude, ChatGPT, Cursor, VS Code…) connect to Fetch's MCP server at https://fetch.nightroll.app/mcp with an API key or OAuth: it runs on Fetch's servers, so it's always current, and needs no install. See QuickStart.

4. Everything else from the terminal

  • fetch mock collection.json: a local mock server from a collection's saved examples
  • every Fetch command: fetch items list, fetch requests send, fetch import, … (fetch --help lists them)

Getting started

fetch login          # connect it to your organization with an API key (Settings → API keys)
fetch agent install  # keep the agent running in the background, starting at login
fetch agent pair     # prints a 6-digit code: enter it in the app (Settings → Fetch Agent, or ⌘K → "Pair the Fetch Agent")

The agent listens only on 127.0.0.1:47823, so nothing else on your network can reach it, and it only answers the Fetch web app after you pair it with a one-time code. fetch run and fetch mock don't need the agent running.

About these builds

  • Not code-signed yet. During the beta the binaries aren't signed or notarized. The install commands above avoid the warnings this causes. If you download a file with your browser instead: on macOS, run xattr -d com.apple.quarantine ./fetch once before opening it; on Windows, chooseMore info → Run anyway when SmartScreen asks (or run Unblock-File .\fetch.exe).
  • Check what you downloaded. Each release lists SHA-256 checksums (SHA256SUMS):shasum -a 256 <file> on macOS and Linux, Get-FileHash <file> in PowerShell.
  • Platforms: macOS 11 or later (separate builds for Apple silicon and Intel; the install command picks the right one), Linux on x86_64 and arm64 (static binaries, any distribution), Windows 10 and 11 on x64 (also runs on Windows on Arm).
  • Built from the same release as the site, so the agent and the web app always match. There's no automatic update yet: rerun the install command to update.
  • What it sends: nothing until you use it. It talks to fetch.nightroll.app only when you sign in or use a cloud command, and to the APIs you send requests to. No telemetry.