Skip to content

Initial Public Release

Latest
Latest

Choose a tag to compare

View all tags
@SerialForBreakfast SerialForBreakfast released this 09 Nov 23:00
· 5 commits to main since this release
1.9.0
bd55cdb

JoesProxy 1.9.0 — First Public Preview

JoesProxy is a free, native network debugging proxy for macOS, with a graphical inspector, command-line tools and optional MCP access for agents.

Development began on November 5, 2024. This first public release brings two years of work on traffic inspection, response mocking, streaming diagnostics and agent-assisted debugging into an open-source preview.

The version reflects that development history: 1.9.0 is the first public release.

Inspect and reproduce network behavior

  • Inspect HTTP and HTTPS requests, responses, headers, bodies and timing.
  • Switch between the full Inspector and Compact HUD.
  • Configure response overrides, blocking, redirects and simulated network conditions.
  • Save recordings for later inspection.
  • Inspect streaming playlists and delivery evidence, and work with synthetic media fixtures.

Prepare realistic mock responses

  • Review JSON edits and prepare batches of synthetic items.
  • Combine response changes and artwork in saved effect bundles.
  • Import and inspect bundles while inactive, with explicit activation review.
  • Choose artwork from the bundled licensed icon catalog or use Joe’s Seal of Approval.
  • On supported systems, request local icon suggestions and similar-item text proposals, then review them before use.

Give agents useful evidence with less bulk

MCP and CLI tools let agents request focused evidence instead of repeatedly reading entire response bodies.

  • Compact response and run briefs, deterministic calculations and digest-qualified repeat reads.
  • Inventory, exact-match search references and briefs for explicitly shared saved artifacts.
  • Compare once: review and authorize an ordered comparison of two saved responses. Revoking either source share suppresses the entire comparison result.
  • Opt-in content-free workflow receipts and offline efficiency reports.
  • Explicit coverage and omission information when captured evidence is incomplete.

Included in this release

Version 1.9.0, build 23 includes the text-size correction for the Inspector and Compact HUD. Text and HUD layout respond to the reading-size setting, and preferences persist across upgrades.

The downloadable app is a universal Apple silicon and Intel build, Developer ID signed and Apple notarized.

Getting started

  1. Download the attached DMG.
  2. Drag JoesProxy into Applications, eject the disk image and launch the app.
  3. Start with the repository’s [setup guide and synthetic HTTP walkthrough](https://github.com/SerialForBreakfast/JoesProxy-Mac/blob/main/docs/GETTING-STARTED.md).

Requires macOS 15.1 or later. Optional on-device generation requires macOS 26 and an available system model; manual authoring remains available.

Automatic updates are not configured in this release. Future versions will require a manual download.

Preview notes

This is the first public preview. Spoken VoiceOver acceptance and physical testing on older supported macOS versions remain pending.

Network recordings can contain sensitive information. Review captures, exports and screenshots before sharing them, and read the [privacy guide](https://github.com/SerialForBreakfast/JoesProxy-Mac/blob/main/docs/PRIVACY.md).

The source is available under the MIT license, with third-party notices retained. This is currently a maintainer-led project; external code contributions and unsolicited pull requests are closed.

For suspected vulnerabilities, follow [SECURITY.md](https://github.com/SerialForBreakfast/JoesProxy-Mac/blob/main/SECURITY.md). Do not post credentials or private captures publicly.

Assets 3
Loading