Skip to content

pitchfork proxy ​

  • Usage: pitchfork proxy <SUBCOMMAND>
  • Effect: read-only

Manage the pitchfork reverse proxy

The reverse proxy routes requests from stable URLs to the daemon's actual listening port. Every daemon with a port gets a hostname automatically, built from the daemon, worktree and project names plus the configured TLD:

https://api.myproject.localhost
https://api.fix-login.myproject.localhost

Slugs are the older mechanism and still work. They are defined in the global config (~/.config/pitchfork/config.toml) under [slugs], each mapping to a project directory and daemon name, and are resolved before hostnames.

Enable the proxy in your pitchfork.toml or settings:

[settings.proxy]
enable = true

Subcommands:

setup     Point this machine's DNS, trust store and ports at the proxy
doctor    Check everything a proxy URL needs in order to work
trust     Install the proxy's TLS certificate into the system trust store
untrust   Remove the proxy's TLS certificate from the system trust store
add       Add a slug mapping to the global config (legacy)
remove    Remove a slug mapping from the global config (legacy)
status    Show hostnames and registered slugs with their current state

Flags ​

  • -h --help — Print help

Subcommands ​

MIT LicenseCopyright © 2026jdx.dev