syncast-cli

Syncast CLI — AI image/video generation and agent integration for Syncast.

Installation

npm install -g syncast
# or: npm install -g syncast-cli
# or: npm install -g @syncast/cli
# all provide `syncast` and `syncast-cli` commands

Quick start

# 1. Log in (device authorization in browser)
syncast auth login

# 2. Verify
syncast auth status

# 3. Generate an image
syncast imagine --prompt "a cat on the moon" --model nano-banana-pro

# 4. Generate a video
syncast video --prompt "ocean waves at sunset" --model veo-3-1

Commands

| Command | Description | |---------|-------------| | syncast auth login | Device authorization login | | syncast auth status | Check session | | syncast auth logout | Clear local session | | syncast imagine | Image generation | | syncast video | Video generation | | syncast task status <id> | Task status / SSE stream | | syncast task cancel <id> | Cancel task | | syncast sync / start | Local file sync (legacy) |

Output format

Default: JSON (agent-friendly). Use --format human for readable text.

syncast imagine -p "hello" --format human

Configuration

• File: ~/.syncast/config.json
• Env: SYNCAST_API_URL or API_URL (default http://localhost:8901)

Agent / Cursor skill

See .agents/skills/syncast-cli/SKILL.md for agent installation instructions.

Example prompt for agents:

Help me install Syncast CLI and log in, then generate a test image.

Development

pnpm install
pnpm build
node dist/cli.js --help

License

MIT