@program-video/cli

@program-video/cli

CLI for the Program video creation platform.

Installation

# Build and link globally
pnpm build
pnpm link --global

# Verify installation
program --version

Development

# Watch mode
pnpm dev

# Type checking
pnpm typecheck

# Lint
pnpm lint

Configuration

Variable	Description	Default
PROGRAM_BASE_URL	OAuth provider URL	http://localhost:3000
PROGRAM_CONVEX_URL	Convex deployment URL	Uses NEXT_PUBLIC_CONVEX_URL

Credentials are stored in ~/.program/credentials.json.

Commands

# Authentication
program auth login          # OAuth browser flow
program auth status --json  # Check auth state
program auth logout         # Clear credentials

# Projects
program project list --json
program project create --title "My Video" --json

# Workflows
program workflow list --json
program workflow run <templateId> --project <id> --json
program workflow status <execId> --watch --json

# Tools (direct composition manipulation)
program tool list --json
program tool exec <name> --project <id> --params '{}' --json

# Messages
program message send "text" --project <id> --json

Documentation

• Full Command Reference: skill/references/COMMANDS.md
• Usage Examples: skill/references/EXAMPLES.md
• Known Issues: KNOWN_ISSUES.md
• Video Quality Guide: VIDEO_QUALITY.md

Agent Integration

This CLI is designed to be used by AI agents via the Program skill:

• Agents read skill/SKILL.md to learn available commands
• All commands support --json for machine-readable output