Tanager .dev
GitHub

Post Documentation

Native macOS HTTP API client, webhook debugger, and Model Context Protocol (MCP) tool inspector.

Welcome to the Post Documentation Portal. Post is an unbloated, local-first macOS desktop application for testing HTTP REST endpoints, capturing and mocking local webhooks, and inspecting Model Context Protocol (MCP) servers.

Documentation Sections

📖 User Guide & Visual Walkthrough

Complete visual guide covering the HTTP Workbench, environments, Keychain & 1Password secrets, auth presets, response chaining, webhooks, and the MCP inspector.

Read User Guide →

🍳 Practical Cookbook & Recipes

Step-by-step engineering recipes for multi-environment Keychain secrets, zero-copy auth chaining, webhook chaos testing, MCP server auditing, and code generation.

Explore Cookbook →

Core Capabilities at a Glance

  • Local-First & Zero Cloud Lock-In: Pure Swift 6 and SwiftUI. Starts in under 100ms with zero Electron bloat, zero forced team logins, and plain-text JSON collections saved directly on your disk.
  • macOS Keychain & 1Password (op://) Secrets: Store sensitive tokens in the native macOS Keychain (kSecClassGenericPassword), or reference 1Password vault secrets inline with op:// URIs and Touch ID.
  • Model Context Protocol (MCP) Dual Transport: Connect to MCP servers over both HTTP/SSE and direct stdio child processes. Auto-generate schema forms for tool calling and inspect server resources and prompts.
  • Embedded Webhook Listener & Chaos Mocking: Spin up an embedded NWListener HTTP server on :9090 to capture webhooks, simulate 429 Too Many Requests or 503 outages with artificial latency, auto-forward payloads, and replay to local services in one click.
  • Response Chaining & Multi-Language Code Export: Extract JSON tokens directly into environment variables upon login, and export tested requests into production-ready Go (net/http), Swift (URLSession), Python (httpx), and cURL.
  • Modal Vim Mode & Slash Commands: Subtle bottom-right :_ toggle, dynamic-growth slash command pills (/json, /uuid, /timestamp, /pretty), and first-line column exclusion.

Installation & GitHub Repository

Homebrew Tap

zsh — brew install post
$ brew tap tanagersoftware/tap $ brew install post

Download Universal DMG

Download the latest precompiled universal release (arm64 & x86_64) directly from the GitHub Releases or visit the Post Product Page.

Source Code

The complete source code, issue tracker, and release tags are hosted on GitHub:

Post Practical Cookbook & Recipes

Step-by-step practical recipes and power workflows for Post.

Post User Guide & Visual Walkthrough

Complete visual walkthrough and reference manual for Post.