hun is a cli for managing multiple dev projects at once — services, ports, logs, processes. you lose context when switching projects; hun preserves it.
why
every multi-project workflow has the same tax. ctrl+c through six terminal tabs. kill the orphan node process. restart docker. remember which port was which. by the time you're ready to actually work on the other project, you've lost ten minutes and the thread you were holding.
hun handles the boring parts so switching projects feels closer to switching tabs.
how it works
run hun init once per project. hun auto-detects your services — node, go, python, docker compose, monorepos, hybrid stacks — and learns the shape of what you're running.
then:
$ hun switch letraz
# stops your current project, boots letraz's services, wires up logs
$ hun run letraz unrag
# runs both in parallel with automatic port offsetting
a background daemon keeps process groups alive, captures output, and detects ports. state survives closing your laptop — pick up exactly where you left off.
features
- auto-detects services across node, go, python, docker compose, monorepos, and hybrid stacks
- automatic port detection and conflict resolution when running multiple projects at once
- aggregated logs — one tail for every service you care about
- focus mode for one-project tunnel vision, multitask mode for running many
- persistent state across terminal sessions and restarts
- status at a glance — what's running, what's not, what's stuck
not a tmux replacement
hun thinks in projects. tmux thinks in sessions and panes. they compose fine — put hun inside tmux if that's your thing. the point isn't to replace your multiplexer; it's to remove the context-switching tax between projects.
install
brew tap hundotsh/tap
brew install hun
open source on github.