Expand description
Reverse proxy server for pitchfork daemons.
Routes <slug>.<tld>:<port> to the daemon’s actual listening port.
Slugs are defined in the global config (~/.config/pitchfork/config.toml)
under [slugs]. Each slug maps to a project directory and daemon name.
§URL Routing
myapp.localhost:7777 → localhost:8080 (via slug)Modules§
- activity
- Per-daemon proxy activity: what the proxy is carrying for each daemon right now, and when it last carried anything.
- dns
- Minimal loopback DNS responder for the proxy TLD.
- doctor
pitchfork proxy doctor— one line per thing that has to be true for a proxy URL to work in a browser.- hostname
- Automatic hostnames for daemons.
- hosts
- /etc/hosts management for the reverse proxy.
- lan_ip
- LAN IP address detection for the reverse proxy.
- mdns
- mDNS address record publishing for LAN mode.
- pac
- Proxy auto-config (PAC) generation.
- server
- Reverse proxy server implementation.
- setup
- Host integration for the proxy:
pitchfork proxy setup,--undo,doctor. - sni
- TLS ClientHello parsing, used to route a connection before any TLS handshake takes place.
- trust
- CA certificate trust management for the reverse proxy.
- worktree
- Git worktree / jj workspace auto-discovery for proxy slug routing.
Functions§
- build_
proxy_ url - Build the URL for a proxy hostname: a legacy slug, or an automatic
<daemon>.<worktree>.<project>host. - effective_
tld - The TLD the proxy actually serves on.