Skip to content

RunPost v0.2.0

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 19 Oct 15:18
· 3 commits to main since this release
v0.2.0
9eeeedf

The HTTP client you and your AI agent share. RunPost is a Postman-like desktop app with a built-in MCP server: your agent (Claude Code, Codex…) runs your saved requests by name, gets compact answers with secrets masked, and you watch every call live — and approve the risky ones. One binary. No account. No telemetry.

RunPost 0.2.0 adds the Postman features that were still missing from day-to-day work.

What's new

  • Import from more tools: Insomnia (v4 and v5 exports) and Bruno (.bru folders, OpenCollection YAML and the JSON export), on top of Postman v2.1, OpenAPI 3, HAR and cURL. Paste text or pick files in the new Import dialog; a pasted cURL opens in a new tab. What gets translated: docs/IMPORT.md.
  • Code snippets: the </> panel turns a request into cURL, fetch, PowerShell or Python requests. Plain variables are resolved and secrets stay as {{variables}}, so a snippet is safe to paste into a chat or a ticket. Agents get the same code with get_request and snippet; there are still 13 MCP tools.
  • GraphQL bodies: query and variables side by side, sent as the standard GraphQL-over-HTTP JSON. Details: docs/REQUESTS.md.
  • Auth: digest (MD5, SHA-256 and SHA-512-256) and OAuth 2.0: client credentials, and authorization code with PKCE and a local callback. Tokens stay in memory or the OS keyring, never in files, the history, MCP output or the UI. Details: docs/AUTH.md.
  • Cookie manager (see, add, edit and delete cookies by domain) and client certificates per host for mutual TLS. Details: docs/NETWORK.md.
  • Saved examples per request: "Save as example" from a response, also imported from and exported to Postman.
  • Find and replace across a collection, with match case, whole word and regex.
  • A trash with undo for collections, folders, requests and environments, kept for 30 days. Details: docs/COLLECTIONS.md.

Changes worth knowing:

  • In the local API, DELETE of a collection, folder, request or environment now answers 200 with the trash entry instead of 204.
  • The MCP get_request tool shows *** instead of credentials written literally in a request's auth.

Install

The builds are not code-signed yet: Windows SmartScreen and macOS Gatekeeper ask for confirmation on the first launch.

Each block ends by putting runpost_mcp (the CLI and MCP server that agents use) on your PATH.

Windows (x64), in PowerShell:

Invoke-WebRequest https://github.com/paul0610/runpost/releases/download/v0.2.0/RunPost_0.2.0_x64-setup.exe -OutFile RunPost-setup.exe
.\RunPost-setup.exe
[Environment]::SetEnvironmentVariable('Path', [Environment]::GetEnvironmentVariable('Path','User') + ";$env:LOCALAPPDATA\RunPost", 'User')

The installer is per user (no admin) and puts runpost_mcp.exe next to the app. RunPost_0.2.0_x64-portable.exe is the app alone, without installing; it needs the WebView2 runtime, which Windows 11 already has.

macOS (Apple silicon):

curl -LO https://github.com/paul0610/runpost/releases/download/v0.2.0/RunPost_0.2.0_aarch64.dmg
hdiutil attach RunPost_0.2.0_aarch64.dmg && cp -R /Volumes/RunPost/RunPost.app /Applications/ && hdiutil detach /Volumes/RunPost
xattr -dr com.apple.quarantine /Applications/RunPost.app && sudo ln -sf /Applications/RunPost.app/Contents/MacOS/runpost_mcp /usr/local/bin/runpost_mcp

Linux (x64, Debian / Ubuntu):

curl -LO https://github.com/paul0610/runpost/releases/download/v0.2.0/RunPost_0.2.0_amd64.deb
sudo apt install ./RunPost_0.2.0_amd64.deb
runpost_app

Or the AppImage: chmod +x RunPost_0.2.0_amd64.AppImage && ./RunPost_0.2.0_amd64.AppImage. If it does not start, install FUSE 2 (libfuse2, or libfuse2t64 on Ubuntu 24.04).

Only the CLI and MCP server, without the desktop app: runpost_mcp_0.2.0_windows-x64.exe, runpost_mcp_0.2.0_macos-arm64.tar.gz or runpost_mcp_0.2.0_linux-x64.tar.gz. Put runpost_mcp on your PATH; runpost_mcp serve --browser opens the same UI in your browser.

Connect your agent

Claude Code (2.1.275 or later), one line in your terminal:

claude plugin install runpost --marketplace paul0610/runpost

Or inside Claude Code: /plugin marketplace add paul0610/runpost, then /plugin install runpost@runpost. The plugin needs runpost_mcp on your PATH. With the RunPost app open on the same workspace, its calls show up in the Agent panel and protected requests wait for your approval.

Codex, Claude Desktop and others: in the app, Agent → Connect agent ▾ copies a ready-made config with your paths. Examples, including an AGENTS.md for Codex, are in docs/mcp-client-configs. The MCP contract is in docs/MCP.md.

Checksums (SHA-256)

SHA256SUMS.txt in the assets lists them too.

890ad620752a9d880c0c74afb8492d875438cba613fca991e848c7e93ec9b94b  RunPost_0.2.0_x64-setup.exe
4bb61c64734212e437aa86f89de44ede7529e9c1586a81121f37f07ee6e003c6  RunPost_0.2.0_x64-portable.exe
624d2233389797549353fa57fb43f33429a5501a7249d5c5fddd173290b14a50  RunPost_0.2.0_aarch64.dmg
89452dd9895822e1635b60ef07a099873ca39145e8e8b786c664a1866c2e2926  RunPost_0.2.0_amd64.deb
410324d5b2a1e02fe9afe8c40590e8d7d24cae541ba64979dfc906cf928c99d2  RunPost_0.2.0_amd64.AppImage
ae695e2bf58bf651bc29b5e81556ea1f89be3ef7e579368a44706bf9b4ab2086  runpost_mcp_0.2.0_windows-x64.exe
21dc4902ae0b2228b4337a8bb53d86c3c11941f38d2634f43d10780ef612ef6f  runpost_mcp_0.2.0_macos-arm64.tar.gz
e0af369091c950fd5a6bea4f226aa38c360cf2d2d56bf4e38148ca93528114ad  runpost_mcp_0.2.0_linux-x64.tar.gz

To check a download:

  • Windows: (Get-FileHash .\RunPost_0.2.0_x64-setup.exe -Algorithm SHA256).Hash.ToLower()
  • macOS: shasum -a 256 RunPost_0.2.0_aarch64.dmg
  • Linux: sha256sum -c SHA256SUMS.txt --ignore-missing (with SHA256SUMS.txt next to the files)

En español

RunPost 0.2.0 trae lo que faltaba de Postman para el día a día:

  • importar desde Insomnia y Bruno, además de Postman, OpenAPI 3, HAR y cURL;
  • snippets de código que nunca llevan un secreto;
  • cuerpos GraphQL;
  • auth digest y OAuth 2.0 (client credentials, y authorization code con PKCE);
  • gestor de cookies y certificados de cliente por host;
  • ejemplos guardados por petición, buscar y reemplazar en una colección y papelera con deshacer.

Instalación y guía en español: README.es.md y la web.

Issues and pull requests are welcome in English or Spanish; look for good first issue. Created by Paul Rojas · MIT license.

Assets 11
Loading