# ProtoPeek

> ProtoPeek is a lightweight local workbench for finding, reaching, and inspecting services without flattening protocol-specific evidence.

Primary site: https://protopeek.shreyam1008.com.np/
Author: https://shreyam1008.com.np/
Repository: https://github.com/shreyam1008/ProtoPeek

## Release truth

- Downloader product page: https://protopeek.shreyam1008.com.np/downloader/

- v0.6.1 is the current stable release with Home, Inspect, Network, Publish, Files and Settings.
- The opt-in v0.0.0-edge prerelease adds the redesigned workspace, persistent grouped navigation, destination resume, mobile command search and local MCP/CLI agents. Download: https://github.com/shreyam1008/ProtoPeek/releases/tag/v0.0.0-edge. Stable installers do not select edge.
- New on Nightly (v0.0.0-nightly): pp update and protopeek update share a verified direct-install updater on Windows, macOS and Linux. Settings > Updates adds manual checks, channel warnings, confirmation, cancellation and restart guidance. Managed installs show their package-manager commands. Older binaries require one installer upgrade first with PROTOPEEK_CHANNEL=nightly. Main/master pushes refresh this one rolling prerelease; stable v0.6.1 and package-manager releases are promoted separately. Legacy Edge is manual-only.
- Edge browser acceptance and remaining native Nmap/live-capture checks: https://protopeek.shreyam1008.com.np/workspace-ui/. Agent setup and activity: https://protopeek.shreyam1008.com.np/ai-agents/.
- Inspect provides gRPC, HTTP saved requests, WebSocket/SSE, Cap’n Proto bootstrap RPC and explicit website/TLS/header/path evidence.
- Network provides native paths on Linux/Windows, TCP port scans, private discovery, optional Nmap, PCAP/PCAPNG metadata, installed Tailscale diagnostics and local device activity on Linux/Windows.
- Cloudflare Tunnel performs explicit local host/config inspection and guarded canonical service operations. Config writes and account mutation remain unavailable.
- Windows x64 includes pinned aria2 1.37.0, extracted on demand after configured and PATH engines. Other platforms require installed aria2. Release archives include notices and a separate source companion.
- The verified resolvers install latest stable from checksum-pinned archives. Homebrew and Scoop manifests identify their package versions and supply aria2 as a dependency.
- Drafts, saved HTTP recipes, appearance and path snapshots use browser-origin storage. Host download settings, queue and bounded history use local files. Closing the browser leaves transfers running while the server stays open; server restart restores recoverable jobs for explicit resume.
- Nmap, dumpcap, Tailscale and cloudflared require their respective installed tools. Cap’n Proto source compilation uses the optional capnp compiler; compiled schemas work without it.
- macOS native path probes and socket/counter activity are unsupported. Headscale, NetBird, integrated elevation/sign-in, deeper packet decoding and returned-capability RPC workflows remain planned.
- Hop country/ASN attribution is optional provider evidence, not proof of a datacenter or return path. Port hints are not verified protocols. Website checks never produce a security score.
- GoBarryGo files and history remain independent; its public redirect and retirement are not complete.

## Public features and guides

- Install ProtoPeek: https://protopeek.shreyam1008.com.np/install/ — Stable · v0.6.1
- Cap’n Proto workbench: https://protopeek.shreyam1008.com.np/capnp-workbench/ — Stable · v0.6.1
- gRPC workbench: https://protopeek.shreyam1008.com.np/grpc-workbench/ — Stable · v0.6.1
- HTTP workbench: https://protopeek.shreyam1008.com.np/http-workbench/ — Stable · v0.6.1
- Learn gRPC: https://protopeek.shreyam1008.com.np/learn-grpc/ — Stable · v0.6.1
- Network workbench: https://protopeek.shreyam1008.com.np/network-workbench/ — Current source · Nightly
- Network evidence boundaries: https://protopeek.shreyam1008.com.np/route-and-nmap-evidence/ — Stable · v0.6.1
- This Device evidence: https://protopeek.shreyam1008.com.np/this-pc/ — Stable · v0.6.1
- Manage Cloudflare Tunnel locally: https://protopeek.shreyam1008.com.np/cloudflare-tunnels/ — Stable · v0.6.1
- Downloader: https://protopeek.shreyam1008.com.np/downloader/ — Stable · v0.6.1
- Website security evidence: https://protopeek.shreyam1008.com.np/security/ — Stable · v0.6.1
- Local AI agents: https://protopeek.shreyam1008.com.np/ai-agents/ — Current source · after v0.6.1
- Settings: https://protopeek.shreyam1008.com.np/settings/ — Stable · v0.6.1
- Feature roadmap: https://protopeek.shreyam1008.com.np/feature-roadmap/ — Stable · v0.6.1
- Transport boundaries: https://protopeek.shreyam1008.com.np/transport-boundaries/ — Architecture guide
- Competitive workflow decisions: https://protopeek.shreyam1008.com.np/competitive-landscape/ — Research record
- VS Code and Open VSX spec: https://protopeek.shreyam1008.com.np/vscode-extension-spec/ — Planned · not shipped
- Workspace navigation and design: https://protopeek.shreyam1008.com.np/workspace-ui/ — Current source

## Stable install

- Homebrew: `brew install shreyam1008/tap/protopeek`
- Scoop: `scoop bucket add shreyam https://github.com/shreyam1008/scoop-bucket`, then `scoop install shreyam/protopeek`
- Unix resolver: `curl -fsSL https://raw.githubusercontent.com/shreyam1008/ProtoPeek/master/install.sh | sh`
- PowerShell resolver: `irm https://raw.githubusercontent.com/shreyam1008/ProtoPeek/master/install.ps1 | iex`

## Agent discovery

- API catalog: https://protopeek.shreyam1008.com.np/.well-known/api-catalog
- OpenAPI document: https://protopeek.shreyam1008.com.np/openapi.json
- ARD capability manifest: https://protopeek.shreyam1008.com.np/.well-known/ai-catalog.json
- MCP Server Card: https://protopeek.shreyam1008.com.np/.well-known/mcp/server-card.json
- Auth metadata: https://protopeek.shreyam1008.com.np/auth.md
- Agent Skill index: https://protopeek.shreyam1008.com.np/.well-known/agent-skills/index.json