hun.shGetting Started
Your first 5 minutes with hun.
Let's take hun for a spin.
We will onboard a project, open the TUI, and run through the core workflow.
Run Onboarding
Start from anywhere and run:
hun onboardChoose your project path in the wizard.
If .hun.yml is missing, hun detects services and creates it.
It then registers the project and can open the TUI directly.
Open the TUI
Run hun from anywhere. This opens your global Command Center.
hunYou will see the TUI.
If your project isn't running yet, press p to open the Project Picker.
Type my-cool-project and hit Enter.
hun will now start your project in Focus Mode.
- Services are starting: Watch them go from
STARTINGtoRUNNINGin real-time. - Logs are live: Select any service to see its output immediately.
This is your new home. You don't need to juggle multiple tabs anymore.
View Logs
Navigate with ↑ / ↓ keys.
Press Enter on a service to expand its logs.
Press Esc to go back to the list.
Restart a Service
Did you change a config file? Need to bounce the API?
Just hover over the service and press r.
Quit TUI (Keep Running)
When you are done looking at logs, just press q.
Your project keeps running in the background.
You can close your terminal, open a new one, and run hun again. Everything will be exactly where you left it.