Releases · paul0610/runpost

Repository navigation

Release list

RunPost v0.2.0 Latest

Latest

github-actions released this 19 Oct 15:18

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

RunPost v0.1.0

github-actions released this 18 Oct 23:05

v0.1.0

21aa8e8

This is the first public release.

Highlights

Postman habits: collections, environments and globals, pm.* scripts (pre-request and tests), Collection Runner with data files, Postman v2.1 import and export, the same keyboard shortcuts.
MCP built in: 13 compact tools over stdio and Streamable HTTP. The agent refers to saved requests by name instead of rewriting URLs, headers and tokens; select, ranges and diffs keep answers small. The whole tools/list is ≈ 1,600 tokens.
Live Agent panel: every call of the model as a row (tool, request, status, ms, raw → sent bytes) with a token meter.
Guardrails: per collection, allowed methods, requests that need your approval in the app (Approve / Deny, 60 s) and a calls-per-minute limit.
Secrets out of the way: masked for the agent, the history and the logs, and optionally kept in the OS keyring instead of the workspace files.
Runner in your terminal and CI: runpost_mcp run <collection> --out junit.
Claude Code plugin with the MCP server, an api-testing skill and /runpost:run, /runpost:suite, /runpost:import.
English and Spanish UI, light and dark themes. Local and Git-friendly: one plain JSON file per collection and environment.

On Windows 11 the desktop app is 19 MB, opens in ≈ 1.1 s and uses ≈ 37 MB at rest (plus the system WebView). Details in docs/BENCH.md.

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.1.0/RunPost_0.1.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.1.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.1.0/RunPost_0.1.0_aarch64.dmg
hdiutil attach RunPost_0.1.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.1.0/RunPost_0.1.0_amd64.deb
sudo apt install ./RunPost_0.1.0_amd64.deb
runpost_app

Or the AppImage: chmod +x RunPost_0.1.0_amd64.AppImage && ./RunPost_0.1.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.1.0_windows-x64.exe, runpost_mcp_0.1.0_macos-arm64.tar.gz or runpost_mcp_0.1.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

Checksums (SHA-256)

SHA256SUMS.txt in the assets lists them too.

4a571f9e607ea4ba79e2bcce0bd81981896dc48225db29cdff92259285fc6ec8  RunPost_0.1.0_x64-setup.exe
778fb6678eda4ba93bafdd2b5883fd62c71b62398fb554b19ae2493e265e8829  RunPost_0.1.0_x64-portable.exe
6713817a873a03035a6479c3541ff987593e711d64cc52ca07901b14627afd90  RunPost_0.1.0_aarch64.dmg
18201314ae7f61895b6f0ef2fb7a3b24b83e16d0b6da6ef380b404d4192ccd0a  RunPost_0.1.0_amd64.deb
84ab662d7f68fffefdb1302c2de546533b852dfb2c1c5b0dcd4067189876578f  RunPost_0.1.0_amd64.AppImage
264794845f334069845bd921cc84744e1ee6f5441a89af1834c6076169441af2  runpost_mcp_0.1.0_windows-x64.exe
868233d437b40c3e7abb87ded30f127aafc2a1482f17b8599f0ee83c970d733b  runpost_mcp_0.1.0_macos-arm64.tar.gz
d2d5fe65c512019606c428806d53cfdbbba4668a36234d7b29a818aeb59e2256  runpost_mcp_0.1.0_linux-x64.tar.gz

To check a download:

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

En español

RunPost 0.1.0 es la primera versión pública: un cliente HTTP de escritorio tipo Postman con servidor MCP integrado, para que tu agente de IA use tus peticiones guardadas con respuestas compactas y los secretos tapados mientras tú ves cada llamada y apruebas las delicadas. La interfaz está en español e inglés. 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

Navigation Menu

Repository navigation

Release list

Choose a tag to compare

Sorry, something went wrong.

Sorry, something went wrong.

Uh oh!

No results found

What's new

Install

Connect your agent

Checksums (SHA-256)

En español

Uh oh!

Choose a tag to compare

Sorry, something went wrong.

Sorry, something went wrong.

Uh oh!

No results found

Highlights

Install

Connect your agent

Checksums (SHA-256)

En español

Uh oh!

Releases: paul0610/runpost

Release list

RunPost v0.2.0

What's new

Install

Connect your agent

Checksums (SHA-256)

En español

Uh oh!

RunPost v0.1.0

Highlights

Install

Connect your agent

Checksums (SHA-256)

En español

Uh oh!