devhost

Your dev stack, on real HTTPS hostnames, with one command. devhost starts every service your app needs, puts each one on a hostname like https://app.localhost, and keeps the whole thing running while you break things.

Stop juggling localhost:3000, localhost:4000, and a terminal tab per service. Auth callbacks, cookies, CORS, and service-to-service URLs behave the way they do in production.

Documentation · Install · How it works

Why devhost

• Real hostnames, real HTTPS. Give each service its own trusted https:// hostname, with path routes and aliases, through one shared proxy. No DNS setup for .localhost names.
• One command for the whole stack. devhost start launches services in dependency order; add --detach to return after readiness and keep the stack running when the terminal closes. Name one app to start it and its dependencies.
• Crashes don't take you down. A failing service shows its error and logs right at its URL, with a Restart button. Everything else keeps running.
• Edit config live. Save devhost.toml and only the affected services restart. A typo never kills the stack.
• Devtools in your page. An optional toolbar with service status, live logs, restarts, Git worktree switching, and your React, Redux, TanStack, Vue, and Jotai devtools in one place.
• Point, and let an agent fix it. Chat with your own Codex or Claude Code from the page: click elements, draw on it, attach a screenshot, and send.

A quick look

# devhost.toml
name = "shop"

[services.web]
command = ["bun", "run", "dev"]
port = 3000
host = "shop.localhost"
dependsOn = ["api"]

[services.api]
command = ["bun", "run", "api"]
port = 4000
host = "api.shop.localhost"
health = { http = "/healthz" }

$ devhost start
shop    | web (primary): https://shop.localhost
shop    | api: https://api.shop.localhost

That's the stack: the API starts first, the web app once the API is healthy, both on HTTPS.

Install

On macOS with Apple silicon:

tag=$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/alexgorbatchev/devhost/releases/latest | sed 's#.*/##')
curl -fsSL "https://github.com/alexgorbatchev/devhost/releases/download/$tag/devhost-$tag-darwin-arm64.tar.gz" | tar -xz
sudo install "devhost-$tag-darwin-arm64/devhost" /usr/local/bin/devhost
devhost caddy download && devhost caddy start

Linux builds and the full setup are in the install guide.

Learn more

The documentation covers every feature, with short videos: routing, running a stack, the toolbar, and chatting with a coding agent.

Using a coding agent? npx skills add alexgorbatchev/devhost --skill devhost teaches it devhost.

License

MIT