optimal-cli

Optimal CLI

Unified command-line interface for agent config sync, financial analytics, content management, and infrastructure.

Installation

# Install globally
npm install -g optimal-cli

# Or use with npx (no install)
npx optimal-cli <command>

Quick Start

1. Install the CLI:

npm install -g optimal-cli

2. Initialize local config:

optimal config init --owner yourname

3. Set up environment variables in ~/.optimal/.env:

# OptimalOS Supabase (for config sync, kanban)
OPTIMAL_SUPABASE_URL=https://hbfalrpswysryltysonm.supabase.co
OPTIMAL_SUPABASE_SERVICE_KEY=your_service_key

# ReturnPro Supabase (for financial data)
RETURNPRO_SUPABASE_URL=https://vvutttwunexshxkmygik.supabase.co
RETURNPRO_SUPABASE_SERVICE_KEY=your_service_key

# Strapi CMS
STRAPI_URL=https://strapi.optimal.miami
STRAPI_API_TOKEN=your_token

# AI Provider (for content generation)
OPENAI_API_KEY=your_key

4. Verify setup:

optimal doctor

5. Sync your agent config (optional):

optimal config push --agent youragent

Commands

Config Sync (Agent Management)

Synchronize OpenClaw configurations across multiple agents.

Command	Description
optimal config push --agent <name>	Push local ~/.openclaw/openclaw.json to cloud
optimal config pull --agent <name>	Pull config from cloud to local
optimal config list	List all saved agent configs
optimal config diff --agent <name>	Compare local vs cloud config
optimal config sync --agent <name>	Two-way sync (newer wins)

Example workflow:

# Push Oracle's config
optimal config push --agent oracle

# Pull it on another machine
optimal config pull --agent oracle

# Auto-sync (detects which is newer)
optimal config sync --agent oracle

Kanban Board

Manage tasks across agents.

Command	Description
optimal board view	Display kanban board
optimal board create --title "Task name"	Create new task
optimal board update --id <uuid> --status done	Update task status
optimal board sync:pull	Pull supabase tasks to obsidian
optimal board sync:push	Push obsidian tasks to supabase
optimal board sync:status	Diff supabase vs obsidian

Financial Analytics (ReturnPro)

Command	Description
optimal audit-financials	Compare staged vs confirmed financials
optimal export-kpis --format csv	Export KPI data
optimal project-budget --adjustment-value 4	Run budget projections
optimal rate-anomalies	Detect rate anomalies
optimal upload-r1 --file data.xlsx --month 2025-01	Upload R1 data

Content Management (Strapi CMS)

Command	Description
optimal generate-newsletter --brand CRE-11TRUST	Generate newsletter
optimal distribute-newsletter --document-id <id>	Send newsletter
optimal generate-social-posts --brand LIFEINSUR	Generate social posts
optimal publish-social-posts --brand CRE-11TRUST	Publish to platforms
optimal blog-drafts	List unpublished blogs
optimal publish-blog --slug my-post	Publish blog post

Infrastructure

Command	Description
optimal deploy <app> --prod	Deploy to Vercel
optimal health-check	Check all services
optimal migrate push --target optimalos	Run DB migrations

Authentication

All config sync operations require Supabase authentication. The CLI uses your service role key for server-side operations.

To get your credentials:

1. Go to Supabase Dashboard
2. Select your project
3. Settings → API → Copy "service_role key"

Environment Variables

Variable	Required	Description
OPTIMAL_SUPABASE_URL	✅	OptimalOS Supabase URL
OPTIMAL_SUPABASE_SERVICE_KEY	✅	OptimalOS service role key
RETURNPRO_SUPABASE_URL	For financial commands	ReturnPro Supabase URL
RETURNPRO_SUPABASE_SERVICE_KEY	For financial commands	ReturnPro service key
STRAPI_URL	For CMS commands	Strapi CMS URL
STRAPI_API_TOKEN	For CMS commands	Strapi API token
OPENAI_API_KEY	For AI commands	OpenAI API key

Multi-Agent Sync Workflow

1. Oracle (primary) makes config changes:

   optimal config sync push --profile oracle
   

2. Opal pulls latest config:

   optimal config sync pull --profile oracle
   # or
   optimal config sync
   

3. Verify sync:

   optimal config list
   

Development