Settings

Settings

Configure wt to match your workflow. All settings are persisted to ~/.config/wt/config.

Accessing Settings

From the main menu

Select ⚙ Settings in the main menu to browse and modify all options interactively.

Preferences wizard

Run wt --wizard to launch the guided preferences wizard. It runs automatically on first launch.

Edit config file directly

Settings are stored as key-value pairs in ~/.config/wt/config. You can edit this file manually.

Reset to defaults

Press Ctrl+R in the Settings menu to reset all values to their defaults.

Config File

Example ~/.config/wt/config file:

~/.config/wt/config
WT_EDITOR=cursor
WT_PLATFORM=auto
WT_WORKTREE_DIR=
WT_AUTO_CD=true
WT_FEATURE_PREFIX=feature/
WT_AUTO_FETCH=true
WT_CLAUDE_MODE=
WT_LIST_LIMIT=20

Available Settings

WT_EDITORauto-detected

Preferred editor for Ctrl+E. When set, this takes priority over auto-detection (Cursor > VS Code > $EDITOR > vim).

Examples: cursor, code, vim, nvim, zed

WT_PLATFORMauto

Git platform for PRs and issues. When set to auto, wt detects the platform from the remote URL.

Values: auto, github, gitlab

WT_WORKTREE_DIRparent of repo

Custom root directory for new worktrees. By default, worktrees are created next to the main repository.

Example: ~/worktrees

WT_AUTO_CDtrue

Automatically navigate to a worktree after selecting it. Set to false to stay in the current directory.

WT_FEATURE_PREFIXfeature/

Prefix used when creating branches from issues. The branch name follows the pattern {prefix}{issue-num}-{title}.

Examples: feature/, feat/, issue/

WT_AUTO_FETCHtrue

Automatically run git fetch before listing PRs or issues. Disable to skip the fetch and speed up navigation.

WT_CLAUDE_MODEask each time

Default Claude mode. When set, skips the mode picker and uses this mode directly.

Values: forced, ask, plan

WT_LIST_LIMIT20

Maximum number of items shown in PR and issue lists. Increase for larger repositories.

Tips

  • *On first launch, wt runs the preferences wizard automatically to set up your editor and platform
  • *Run wt --wizard at any time to re-run the wizard
  • *Settings take effect immediately — no need to restart wt
  • *Leave a value empty to use the default behavior