CLI Reference — Dispatch

Usage

dispatch [command | flag]

Running dispatch with no arguments launches the interactive TUI.

Commands

Command / Flag	Description
`open <id>`	Resume a session by ID, alias, or short prefix. Flags: --last, --print, --stdin, --mode, --repo, --branch, --folder, --current, --agent, --model, --yolo.
`new [dir]`	Start a new session from the CLI, with --mode/--agent/--model/--yolo overrides.
`search [query]`	Non-interactive session search with --json, --table, --ids, --deep, and filters.
`stats`	Session totals and breakdowns by repository, branch, folder, and host, with --json, --csv, --calendar, --top.
`export <id>`	Export a session as Markdown, JSON, or HTML, with --redact, --stdout, and batch by --repo/--branch/--query.
`info <id>`	Print a concise summary of one session.
`compare <a> <b>`	Compare two sessions side by side, with --json.
`tags`	List all tags with per-tag session counts, with --json, --csv, or --markdown.
`tag <id>`	Add, remove, or set tags on a session (--add, --remove, --set, --json).
`notes`	Get, set, or clear a session's local notes.
`views`	List named views with --json or --csv, and switch the active view.
`aliases`	List all session aliases.
`alias list`	List all session aliases, with --json for scripting.
`watch`	Monitor attention state across sessions (--once, --json, --interval).
`prune`	Report and remove stale config entries (--apply, --json).
`config`	Read and set preferences (list, get, set, unset, edit, path).
`doctor`	Print setup diagnostics, with --json.
`completion <shell>`	Generate a completion script (bash, zsh, fish, powershell).
`man`	Generate a roff man page.
`update`	Check GitHub Releases for a newer version and upgrade in-place.
`version`	Print the version number and exit.
`help`	Show usage information and exit.

Flags

Command / Flag	Description
`-h, --help`	Show usage information and exit.
`-v, --version`	Print the version number and exit.
`--demo`	Launch with a demo database of synthetic sessions.
`--clear-cache`	Reset all configuration to defaults.
`--reindex`	Rebuild the session store index via Copilot CLI.

Environment Variables

Command / Flag	Description
`DISPATCH_DB`	Path to a custom session store database.
`DISPATCH_SESSION_STATE`	Path to a custom session state directory.
`DISPATCH_CONFIG`	Path to a custom config file (overrides the default location).
`DISPATCH_LOG`	Path to a log file. Enables debug logging when set.
`DISPATCH_NO_UPDATE_CHECK`	Skip the background release check when set to 1, true, yes, or on.

Examples

# Launch the TUI
dispatch

# Resume the most recent session
dispatch open --last

# Search sessions in table form
dispatch search auth --table

# Print stats as JSON
dispatch stats --json

# Check for updates
dispatch update

# Try with demo data
dispatch --demo

# Use a custom database
DISPATCH_DB=~/my-sessions.db dispatch