How to Set Up Bare Process Mode

This guide shows how to configure hako to manage development processes directly on your host machine.

Assumptions

• Project does not use Docker for development.
• You want hako to manage process lifecycle, health checks, and logs.

Steps

1. Configure services in hako.yml Create or edit hako.yml in your project root. Define the command to start your service and the environment variable for the assigned port.

   services:
     dev:
       cmd: "npm run dev"
       port_var: PORT
       ready: "curl -sf http://localhost:$PORT/health"

2. Initialize the environment Create a new worktree and start the processes.

   hako new feature-branch --start

3. Verify service health Check the status of your services.

   hako status feature-branch

4. Inspect logs View the output of a specific service.

   hako logs feature-branch dev

Multiple services

You can define multiple services in the services section. Each service will be assigned a unique port.

services:
  web:
    cmd: npm run dev:web
    port_var: PORT_WEB
  worker:
    cmd: npm run dev:worker

Process artifacts

Hako stores process metadata in the .hako directory within the worktree:

• Logs: .hako/logs/{service}.log
• PIDs: .hako/pids/{service}.pid

See also

• CLI Reference
• Configuration Reference