Sync Commands

Discord sync, config profile management, bot registration.

Commands

optimal sync discord:init

Create Discord channels for all active projects

Flag	Description	Default	Required
--dry-run	Preview without creating

optimal sync discord:init
optimal sync discord:init --dry-run

optimal sync discord:push

Push Supabase tasks to Discord threads

Flag	Description	Default	Required
--dry-run	Preview without creating

optimal sync discord:push
optimal sync discord:push --dry-run

optimal sync discord:pull

Pull Discord thread state into Supabase

Flag	Description	Default	Required
--dry-run	Preview without changes

optimal sync discord:pull
optimal sync discord:pull --dry-run

optimal sync discord:status

Show diff between Discord threads and Supabase tasks

optimal sync discord:status

optimal sync discord:sync

Bidirectional sync: push Supabase tasks to Discord, then pull Discord state to Supabase

Flag	Description	Default	Required
--dry-run	Preview without making changes

optimal sync discord:sync
optimal sync discord:sync --dry-run

optimal sync discord:watch

Start live Discord bot — syncs signals and threads in real-time

Flag	Description	Default	Required
--role <name>	Required Discord role name for access	Optimal

optimal sync discord:watch
optimal sync discord:watch --role Optimal

optimal sync config

Manage optimal-cli local/shared config profile

optimal sync config init

Create a local config scaffold (overwrites with --force)

Flag	Description	Default	Required
--owner <owner>	Config owner (default: $OPTIMAL_CONFIG_OWNER or $USER)
--profile <name>	Profile name	default
--brand <brand>	Default brand	CRE-11TRUST
--timezone <tz>	Default timezone	America/New_York
--force	Overwrite existing config

optimal sync config init --owner optimal-tech --brand CRE-11TRUST

optimal sync config doctor

Validate local config file and print health details

optimal sync config doctor

optimal sync config show

Display current local config in full

Flag	Description	Default	Required
--json	Output as JSON

optimal sync config show
optimal sync config show --json

optimal sync config export

Export local config to a JSON path

Flag	Description	Default	Required
--out <path>	Output path for JSON export		yes

optimal sync config export --out ./optimal-config-backup.json

optimal sync config import

Import local config from a JSON path

Flag	Description	Default	Required
--in <path>	Input path for JSON config		yes

optimal sync config import --in ./optimal-config-backup.json

optimal sync config list

List all profiles in the shared registry

Flag	Description	Default	Required
--owner <name>	Filter by owner

optimal sync config list
optimal sync config list --owner oracle

optimal sync config sync

Sync local profile with shared registry

optimal sync config sync pull

Pull config profile from shared registry into local config

Flag	Description	Default	Required
--profile <name>	Registry profile name	default
--owner <name>	Config owner (defaults to local config or OPTIMAL_CONFIG_OWNER)

optimal sync config sync pull --profile default

optimal sync config sync push

Push local config profile to shared registry

Flag	Description	Default	Required
--agent <name>	Agent/owner name (defaults to local config or OPTIMAL_CONFIG_OWNER)
--profile <name>	Registry profile name	default
--force	Force write even on conflict

optimal sync config sync push --profile default

optimal sync register

Register this bot with admin config and sync credentials

Flag	Description	Default	Required
--agent <name>	Agent/bot name
--email <email>	Owner email (your email)
--admin	Register as admin (publishes config for other bots)

optimal sync register --agent bot1 --email you@example.com
optimal sync register --agent oracle --email you@example.com --admin

optimal sync bots

List registered bots

optimal sync bots

optimal sync npm:watch

Check npm registry for new version of optimal-cli

Flag	Description	Default	Required
--package <name>	Package name to check	optimal-cli

optimal sync npm:watch
optimal sync npm:watch --package optimal-cli