Configuration

Quick Setup with son setup

Configure everything via an interactive TUI. No config files, no CLI flags. Just run son setup and answer a few questions.

Terminal
~ $ son setup
?Dev directories:
[•]~/dev
[ ]~/projects
?Default terminal:
[•]iTerm2
[ ]tmux
[ ]WezTerm
?Preferred editor:
[ ]VS Code
[•]Neovim
[ ]Cursor
[ ]Zed
Configuration saved to ~/.config/son/config.toml

Why use son setup?

Instead of reading documentation and manually editing config files, just run son setup. The interactive TUI guides you through every option with sensible defaults.

What you can configure

  • Dev directories — where son scans for your projects. Add multiple directories for monorepos or scattered workspaces.
  • Default terminal — iTerm2, tmux, or WezTerm. son detects what you have installed automatically.
  • Preferred editor — VS Code, Cursor, Zed, Neovim, or any editor that opens from CLI.
  • Default layout — split horizontally, vertically, or grid. Override per-project later with .son.toml.
  • Frecency decay — tune how quickly old projects drop in the ranking.

After setup

Once configured, just run son to launch the project picker. Your settings are saved to ~/.config/son/config.toml — you can edit this file directly or re-run son setup anytime.

Config file location

On macOS: ~/.config/son/config.toml

On Linux: ~/.config/son/config.toml

See all options in the configuration reference.