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.
`preview_position`	string	`"right"`	Position of the preview pane: right, bottom, left, top.
`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 (see Pane Direction Semantics below).
`custom_command`	string	`""`	Custom launch command. {sessionId} is replaced with the session ID.
`excluded_dirs`	array	`[]`	Directory paths to hide from the session list.
`favoriteSessions`	array	`[]`	Session IDs starred as favorites.
`theme`	string	`"auto"`	Color scheme: auto or a named scheme.
`workspace_recovery`	bool	`true`	Detect sessions interrupted by crash/reboot. Disable if you see false positives.

Example

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

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}"

Pane Direction Semantics

When launch_mode is "pane", the pane_direction value maps to Windows Terminal's -H / -V split-pane flags:

down → -H — horizontal split (divider runs horizontally, new pane below)
up → -H — horizontal split (WT controls actual placement; closest available)
right → -V — vertical split (divider runs vertically, new pane to the right)
left → -V — vertical split (WT controls actual placement; closest available)
auto / empty — no flag; Windows Terminal decides automatically

Note: -H and -V control split orientation only (the direction the divider runs). Windows Terminal decides actual pane placement based on available space.