Configuration — Dispatch

Config File Location

Linux — ~/.config/dispatch/config.json
macOS — ~/Library/Application Support/dispatch/config.json
Windows — %APPDATA%\dispatch\config.json

Options

Key	Type	Default	Description
`default_shell`	string	`""`	Preferred shell (bash, zsh, pwsh, cmd.exe). Empty = auto-detect.
`default_terminal`	string	`""`	Terminal emulator. Empty = auto-detect.
`default_time_range`	string	`"1d"`	Time filter on startup: 1h, 1d, 7d, all.
`default_sort`	string	`"updated"`	Sort field: updated, created, turns, name, folder.
`default_pivot`	string	`"folder"`	Grouping mode: none, folder, repo, branch, date.
`show_preview`	bool	`true`	Show preview pane on startup.
`max_sessions`	int	`100`	Maximum sessions to load from the store.
`yoloMode`	bool	`false`	Pass --allow-all to Copilot CLI (auto-confirm commands).
`agent`	string	`""`	Pass --agent <name> to Copilot CLI.
`model`	string	`""`	Pass --model <name> to Copilot CLI.
`launch_mode`	string	`"tab"`	How to open sessions: in-place, tab, window, pane.
`pane_direction`	string	`"auto"`	Split direction for pane mode: auto, right, down, left, up.
`custom_command`	string	`""`	Custom launch command. {sessionId} is replaced with the session ID.
`excluded_dirs`	array	`[]`	Directory paths to hide from the session list.
`theme`	string	`"auto"`	Color scheme: auto or a named scheme.

Example

{
  "default_shell": "",
  "default_terminal": "",
  "default_time_range": "1d",
  "default_sort": "updated",
  "default_pivot": "folder",
  "show_preview": true,
  "max_sessions": 100,
  "yoloMode": false,
  "agent": "",
  "model": "",
  "launch_mode": "tab",
  "pane_direction": "auto",
  "custom_command": "",
  "excluded_dirs": [],
  "theme": "auto"
}

Themes

Five built-in color schemes:

Dispatch Dark
Dispatch Light
Campbell
One Half Dark
One Half Light

Set theme to auto for automatic light/dark detection based on your terminal.

Custom Themes

Add custom schemes using Windows Terminal JSON format in the schemes config array. Each scheme's name field becomes available in the settings theme selector.

"schemes": [
  {
    "name": "My Custom Theme",
    "background": "#1a1b26",
    "foreground": "#c0caf5",
    "black": "#15161e",
    "red": "#f7768e",
    "green": "#9ece6a",
    "yellow": "#e0af68",
    "blue": "#7aa2f7",
    "purple": "#bb9af7",
    "cyan": "#7dcfff",
    "white": "#a9b1d6"
  }
]

Custom Command

Set custom_command to replace the default Copilot CLI launch command entirely. Use {sessionId} as a placeholder for the session ID.

When a custom command is set, the Agent, Model, and Yolo Mode fields are ignored (dimmed in the settings panel).

"custom_command": "my-tool resume {sessionId}"