CLI Reference
Commands, flags, and environment variables.
Usage
dispatch [command | flag]Running dispatch with no arguments launches the interactive TUI.
Commands
| Command / Flag | Description |
|---|---|
help | Show usage information and exit. |
version | Print the version number and exit. |
update | Check GitHub Releases for a newer version and upgrade in-place. |
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_LOG | Path to a log file. Enables debug logging when set. |
Examples
# Launch the TUI
dispatch
# Check for updates
dispatch update
# Try with demo data
dispatch --demo
# Use a custom database
DISPATCH_DB=~/my-sessions.db dispatch
# Enable debug logging
DISPATCH_LOG=/tmp/dispatch.log dispatch
# Reset config and reindex
dispatch --clear-cache
dispatch --reindex