Skip to content

RunPost v0.1.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 18 Oct 23:05
· 9 commits to main since this release
v0.1.0
21aa8e8

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.

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

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.

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
Loading