Hako

Type: array of strings
Default: [~/.hako/worktrees]

Global configuration is located at ~/.config/hako/config.yml. This configuration is shared between the CLI and the macOS app.

search_paths

Directories where hako looks for environments. This is used by hako ls --all --json and the macOS app.

When hako new creates a worktree in a non-default directory (via HAKO_DIR or worktree_dir), the path is automatically added to search_paths.

search_paths:
  - /Users/me/.hako/worktrees
  - /Users/me/projects/worktrees

Variable	Default	Description
`HAKO_DIR`	`~/.hako/worktrees`	Worktree base directory. Overrides `worktree_dir` in `hako.yml`.
`HAKO_HOME`	`~/.hako`	Hako installation home. Contains `repo/`, `ports.json`, `ports.lock`.
`HAKO_INSTALL_DIR`	`~/.local/bin`	Binary install location. Used by `install.sh`.
`HAKO_REGISTRY_FILE`	`~/.hako/ports.json`	Port registry file path.
`HAKO_REGISTRY_LOCK`	`~/.hako/ports.lock`	Port registry lock directory path.
`HAKO_HOOK_SILENT`	unset	Set to `1` to suppress hook output to the terminal (still logged).

File	Purpose
`~/.config/hako/config.yml`	Global config (`search_paths`)
`~/.hako/ports.json`	Port registry (persistent assignments)
`~/.hako/ports.lock/`	Port registry lock (directory-based)
`~/.hako/repo/`	Hako source (installed by `install.sh`)
`~/.hako/worktrees/{repo}/{branch}/`	Default worktree location
`{worktree}/.env.hako`	Generated port and environment variables
`{worktree}/.hako/`	Bare mode runtime state
`{worktree}/.hako/pids/{service}.pid`	Process ID files
`{worktree}/.hako/logs/{service}.log`	Service log files
`{worktree}/.hako/manifest.json`	Runtime metadata (repo, branch, port_base, mode, services, created_at)
`{repo}/hako.yml`	Per-repo configuration
`{git-common-dir}/hako/logs/`	Hook execution logs