@genspark/cli

v1.0.7

Published

4 hours ago

CLI tool for Genspark Tool API - search, crawl, analyze images, generate media

Genspark CLI (`gsk`)

One CLI. Every AI capability. Search, generate, analyze, communicate — all from your terminal.

gsk is the command-line interface for the Genspark AI platform. It unifies 30+ AI tools behind a single binary: web search, image/video/audio generation with 40+ models, document analysis, media transcription, cloud file management, email, calendar, AI phone calls, stock data, social media data (Twitter, Instagram, Reddit), and autonomous AI agents — all with clean JSON output for seamless integration with AI coding assistants, automation pipelines, and scripts.

Capability Map

| Category | What You Get | |----------|-------------| | 🔍 Search | Web search, image search | | 📄 Documents | Crawl pages, summarize PDFs/docs | | 🎨 Images | 16 models: GPT Image, Gemini, Flux 2, Imagen 4, Recraft, Ideogram, Seedream ... | | 🎬 Videos | 14 models: Kling V3, Veo 3.1, Sora 2, Hailuo, Wan, Runway, PixVerse, Seedance ... | | 🎵 Audio | 14 models: Gemini TTS, ElevenLabs, MiniMax, Mureka, CassetteAI, Lyria 2 ... | | 🧠 Analysis | Image/video/audio understanding, OCR, video style replication | | 📝 Transcribe | Whisper, Gemini, ElevenLabs Scribe | | ☁️ AI Drive | Cloud file storage, download, compress | | 📧 Email | Gmail & Outlook: read, search, send | | 📅 Calendar | Google & Outlook: list, create events | | 📞 Phone | AI-powered phone calls to businesses | | 📈 Stocks | Real-time stock prices | | 📱 Social Media | Twitter/X, Instagram, Reddit — search posts/users, get comments, connections, and more (30 APIs) | | 🤖 Agents | Podcasts, docs, slides, deep research, fact-checking, websites, batch media generation | | 🔊 Voice | Voice cloning, voice changer |

Installation

npm install -g @genspark/cli

Requires Node.js >= 18.

Quick Start

# Log in via browser
gsk login

# Search the web
gsk search "latest AI news"

# Generate an image
gsk img "A beautiful sunset over mountains" -o ./sunset.png

# Crawl a webpage
gsk crawl "https://example.com/article"

Authentication

gsk login

This opens a browser for authentication and saves the API key to ~/.genspark-tool-cli/config.json.

Alternatively, provide an API key directly:

# Via environment variable
export GSK_API_KEY="gsk_..."

# Via CLI option
gsk search "query" --api-key "gsk_..."

To check your current identity:

gsk login-info
gsk me          # shorthand

To log out:

gsk logout

Configuration

Config is loaded from three sources (highest priority first):

CLI options — --api-key, --base-url, etc.
Environment variables — GSK_API_KEY, GSK_BASE_URL, GSK_PROJECT_ID
Config file — ~/.genspark-tool-cli/config.json

{
  "api_key": "gsk_...",
  "base_url": "https://www.genspark.ai",
  "project_id": "project_abc123",
  "debug": false,
  "timeout": 300000
}

Global Options

| Option | Env Var | Default | Description | |--------|---------|---------|-------------| | --api-key <key> | GSK_API_KEY | — | API key (required) | | --base-url <url> | GSK_BASE_URL | https://www.genspark.ai | API base URL | | --project-id <id> | GSK_PROJECT_ID | — | Project ID for access control | | --debug | — | false | Enable debug output | | --timeout <ms> | — | 300000 (5 min) | Request timeout | | --output <format> | — | json | Output format: json or text | | --refresh | — | — | Force refresh cached tool schemas |

Commands

list-tools (alias: `ls`)

List all available tools.

gsk list-tools
gsk ls

login-info (alias: `me`)

Show your current account info — email, name, and membership plan.

gsk login-info
gsk me

init-opencode

Generate an .opencode.json config file for OpenCode, pre-configured to use Genspark's LLM proxy with your API key.

# Generate with default model (claude-opus-4-6-1m)
gsk init-opencode

# Specify a different default model
gsk init-opencode --model claude-sonnet-4-6

# Write to a custom path
gsk init-opencode -o ./my-project/.opencode.json

| Option | Default | Description | |--------|---------|-------------| | --model <name> | claude-opus-4-6-1m | Default model for OpenCode | | -o, --out <path> | .opencode.json (cwd) | Output file path |

Search & Crawl

web_search (alias: `search`)

Search the web.

gsk search "latest AI news"

crawler (alias: `crawl`)

Extract content from a web page or document.

gsk crawl "https://example.com/article"

summarize_large_document (alias: `summarize`)

Analyze a document and answer questions about it.

gsk summarize "https://example.com/report.pdf" --question "What are the key findings?"

| Option | Description | |--------|-------------| | <url> | Document URL (required, positional) | | --question <text> | Question about the document |

image_search (alias: `img-search`)

Search for images on the web.

gsk img-search "modern architecture"

Media Analysis & Transcription

understand_images (alias: `analyze`)

Analyze images with AI vision model.

gsk analyze "Describe this image" -i "https://example.com/image.jpg"
gsk analyze "Extract all text" -i "https://img1.jpg" "https://img2.jpg"
gsk analyze "What's in this photo?" -i ./photo.jpg

| Option | Default | Description | |--------|---------|-------------| | -i, --image_urls <url...> | — | Image URL(s) or local file path(s) to analyze (required) | | -r, --instruction <text> | — | Custom analysis instruction |

Image Generation

image_generation (alias: `img`)

Generate images using AI. Supports text-to-image and image-to-image.

# Text-to-image
gsk img "A beautiful sunset over mountains" -r "16:9" -o ./sunset.png
gsk img "Modern office at night" -s "4k" -r "1:1"

# Image-to-image (reference-based)
gsk img "A portrait in similar style" -i ./reference.png

| Option | Default | Description | |--------|---------|-------------| | -r, --aspect_ratio <ratio> | 1:1 | Aspect ratio (1:1, 16:9, 9:16) | | -s, --image_size <size> | auto | Image size: auto, 2k, 4k | | -m, --model <name> | — | Model to use (optional) | | -i, --image_urls <url...> | — | Reference image URL(s) or local file(s) for image-to-image | | -o, --output-file <path> | — | Download the generated file to a local path |

Video Generation

video_generation (alias: `video`)

Generate videos using AI.

gsk video "A cat playing with yarn" -m "kling/v1.6/standard" -d 5 -o ./cat.mp4
gsk video "Sunrise over a beach" -m "minimax/hailuo-02/standard" -r "16:9" -d 8

# Image-to-video
gsk video "Camera pan around the subject" -m "kling/v1.6/standard" -i ./photo.jpg

| Option | Default | Description | |--------|---------|-------------| | -m, --model <name> | — | Model (required). e.g., kling/v1.6/standard, minimax/hailuo-02/standard | | -r, --aspect_ratio <ratio> | 16:9 | Aspect ratio | | -d, --duration <sec> | 5 | Duration in seconds (2-15) | | -i, --image_urls <url...> | — | Reference image URL(s) or local file(s) | | -a, --audio_url <url> | — | Audio URL for soundtrack | | -o, --output-file <path> | — | Download the generated file to a local path |

Audio Generation

audio_generation (alias: `audio`)

Generate audio: TTS, music, or sound effects.

# Text-to-speech
gsk audio "Hello, welcome to Genspark!" -m "google/gemini-2.5-pro-preview-tts" -r "professional female voice"
gsk audio "Hello, welcome to Genspark!" -m "google/gemini-2.5-pro-preview-tts" -o ./hello.mp3

# Music with lyrics
gsk audio "A pop song" -m "fal-ai/minimax/speech-2.6-hd" -l "Verse 1: ..." -d 120

# Sound effect
gsk audio "Door creaking slowly open" -m "sfx-model"

| Option | Default | Description | |--------|---------|-------------| | -m, --model <name> | — | Model (required). e.g., elevenlabs/v3-tts, fal-ai/minimax/speech-2.6-hd | | -d, --duration <sec> | 0 (auto) | Duration in seconds | | -r, --requirements <text> | — | Voice requirements for TTS | | -l, --lyrics <text> | — | Lyrics for song generation | | -o, --output-file <path> | — | Download the generated file to a local path |

File Transfer

upload

Upload a local file and get a URL for use in other commands.

gsk upload "./image.png"
gsk upload "./document.pdf"

download

Download a file from a file wrapper URL.

# Get download URL only
gsk download "/api/files/s/abc123"

# Download and save to local file
gsk download "/api/files/s/abc123" -s "./downloaded.png"

| Option | Description | |--------|-------------| | -s, --save <path> | Download and save to local file path |

analyze_media (alias: `media-analyze`)

Analyze various types of media content including images, audio, and video.

gsk media-analyze -i "https://example.com/image.jpg" -r "Describe the content"
gsk media-analyze -i "https://example.com/video.mp4" -r "Summarize the video"

| Option | Default | Description | |--------|---------|-------------| | -i, --media_urls <urls> | — | Media URL(s) to analyze (required) | | -r, --requirements <text> | — | Analysis instructions |

audio_transcribe (alias: `transcribe`)

Transcribe audio files to text.

gsk transcribe -i "https://example.com/audio.mp3"
gsk transcribe -i ./meeting.wav -m "whisper-large-v3"

| Option | Default | Description | |--------|---------|-------------| | -i, --audio_urls <url...> | — | Audio URL(s) or local file(s) to transcribe (required) | | -m, --model <name> | — | Transcription model to use |

AI Drive (Cloud Storage)

aidrive (alias: `drive`)

AI-Drive file storage and management. List, create, delete, move files and directories. Download videos, audio, and files from URLs directly to AI-Drive.

# List files in root directory
gsk drive ls
gsk drive ls -p "/documents" -f file

# Create directory
gsk drive mkdir -p "/my-folder"

# Move file
gsk drive move -p "/old-path/file.txt" --target_path "/new-path/file.txt"

# Download video/audio/file to AI-Drive
gsk drive download_video --video_url "https://example.com/video.mp4" --target_folder "/videos"
gsk drive download_file --file_url "https://example.com/doc.pdf" --target_folder "/docs"

# Upload inline text content to AI-Drive
gsk drive upload --file_content "Hello World" --upload_path "/notes/hello.txt"

# Upload a local file directly to AI-Drive (streaming, supports 100MB+ files)
gsk drive upload --local_file ./report.pdf --upload_path /docs/report.pdf
gsk drive upload --local_file ./video.mp4 --upload_path /videos/demo.mp4
gsk drive upload --local_file ./photo.png              # upload_path defaults to /photo.png
gsk drive upload --local_file ./doc.pdf --upload_path /docs/doc.pdf --override  # overwrite existing

# Get readable URL for a file
gsk drive get_readable_url -p "/documents/report.pdf"

# Compress/decompress
gsk drive compress -p "/my-folder"
gsk drive decompress -p "/archive.zip"

| Option | Default | Description | |--------|---------|-------------| | -p, --path <path> | — | File or directory path in AI-Drive | | -f, --filter_type <type> | all | Filter: all, file, directory | | --file_type <type> | all | File type filter: all, audio, video, image | | --target_path <path> | — | Target path for move operations | | --target_folder <path> | — | Target folder for downloads | | --video_url <url> | — | Video URL for download_video action | | --audio_url <url> | — | Audio URL for download_audio action | | --file_url <url> | — | File URL for download_file action | | --file_name <name> | — | Custom file name for downloads | | --file_content <text> | — | Inline text content to upload | | --local_file <path> | — | Local file path to upload directly to AI-Drive (streaming, no size limit) | | --upload_path <path> | — | Destination path for upload (defaults to /<filename> for --local_file) | | --override | false | Overwrite an existing file at the destination path |

AI Agents & Tasks

create_task (alias: `task`)

Create and execute tasks using specialized AI agents.

# Create a podcast
gsk task podcasts --task_name "AI Trends" --query "Create a podcast about AI trends" --instructions "Focus on practical applications"

# Create a document
gsk task docs --task_name "Quantum Report" --query "Write a report on quantum computing" --instructions "Include recent breakthroughs"

# Create slides
gsk task slides --task_name "Q4 Results" --query "Create a Q4 results presentation" --instructions "Use charts and data"

# Deep research
gsk task deep_research --task_name "Fusion Energy" --query "Research fusion energy advances" --instructions "Cover public and private sector"

# Fact-check a claim
gsk task cross_check --task_name "Earth shape" --query "The Earth is flat" --instructions "Verify this claim with evidence"

| Option | Default | Description | |--------|---------|-------------| | --task_name <name> | — | Name for the task (required) | | --query <text> | — | Query describing what to create (required) | | --instructions <text> | — | Detailed instructions (required) |

Supported task types: super_agent, podcasts, docs, slides, deep_research, website, video_generation, audio_generation, meeting_notes, cross_check

Stock Prices

stock_price (alias: `stock`)

Retrieve stock price information and financial data.

gsk stock AAPL
gsk stock MSFT

email

Read and send emails from your connected Gmail or Outlook account.

Requirements: Connect Gmail or Outlook in Genspark Account Settings → Integrations.

email list

List emails from a folder.

# List inbox (default)
gsk email list

# List sent folder, limit to 5 emails
gsk email list sent -n 5

# List only unread emails
gsk email list --unread_only

# List emails after a specific date
gsk email list --after_date 2026-03-01

# Use a specific account (when multiple accounts are connected)
gsk email list -a [email protected]

| Option | Default | Description | |--------|---------|-------------| | [folder] | inbox | Folder: inbox, sent, drafts, trash, spam, archive, or a custom label | | -n, --limit <n> | 20 | Maximum number of emails to return | | --unread_only | false | Return only unread emails | | --after_date <YYYY-MM-DD> | — | Return emails after this date | | --before_date <YYYY-MM-DD> | — | Return emails before this date | | -a, --from_account <email> | — | Account email address (for multi-account) |

email read

Read a specific email by ID.

# Read a specific email (get ID from email list output)
gsk email read 19cbfecd7fb14d46

# Ask a specific question about the email
gsk email read 19cbfecd7fb14d46 "What action is required?"

# Specify account for multi-account setups
gsk email read 19cbfecd7fb14d46 -a [email protected]

| Option | Default | Description | |--------|---------|-------------| | <id> | — | Email ID from email list or email search (required) | | -a, --from_account <email> | — | Account email address (for multi-account) |

email search

Search emails using a query string.

# Search by subject
gsk email search "meeting agenda"

# Gmail query syntax
gsk email search "from:[email protected] subject:budget"

# Search with date range
gsk email search "invoice" --after_date 2026-01-01 --before_date 2026-03-01

# Limit results
gsk email search "quarterly report" -n 5

| Option | Default | Description | |--------|---------|-------------| | <query> | — | Search query (Gmail GQL or Outlook KQL) (required) | | -n, --limit <n> | 20 | Maximum number of results | | --after_date <YYYY-MM-DD> | — | Return emails after this date | | --before_date <YYYY-MM-DD> | — | Return emails before this date | | -a, --from_account <email> | — | Account email address (for multi-account) |

email send

Send a new email.

# Send a plain text email
gsk email send --to [email protected] --subject "Hello" --body "Hi there!"

# Send to multiple recipients
gsk email send --to "[email protected],[email protected]" --subject "Team Update" --body "..."

# Send HTML email
gsk email send --to [email protected] --subject "Newsletter" --body "<h1>Title</h1><p>...</p>" --content_type text/html

# Send with CC and BCC
gsk email send --to [email protected] --subject "Meeting" --body "..." --cc [email protected] --bcc [email protected]

# Send from a specific account
gsk email send --to [email protected] --subject "Hi" --body "..." -a [email protected]

| Option | Default | Description | |--------|---------|-------------| | --to <addresses> | — | Recipient(s), comma-separated (required) | | --subject <text> | — | Email subject (required) | | --body <text> | — | Email body (required) | | --cc <addresses> | — | CC recipient(s), comma-separated | | --bcc <addresses> | — | BCC recipient(s), comma-separated | | --content_type <type> | text/plain | Body content type: text/plain or text/html | | -a, --from_account <email> | — | Account to send from (for multi-account) |

calendar

List and create calendar events from your connected Google Calendar or Outlook account.

Requirements: Connect Google Calendar or Outlook in Genspark Account Settings → Integrations.

calendar list

List upcoming calendar events.

# List events in the next 7 days (default)
gsk calendar list

# List events in a specific time range
gsk calendar list --time_min 2026-03-10T00:00:00Z --time_max 2026-03-15T23:59:59Z

# Search for events by keyword
gsk calendar list --filter_query "standup"

# Use a specific calendar account
gsk calendar list -a [email protected]

| Option | Default | Description | |--------|---------|-------------| | --time_min <ISO8601> | now | Start of time range (e.g., 2026-03-10T00:00:00Z) | | --time_max <ISO8601> | +7 days | End of time range | | --filter_query <text> | — | Filter events by title/subject keyword | | -a, --from_account <email> | — | Calendar account email (for multi-account) |

calendar create

Create a new calendar event.

# Create a simple event
gsk calendar create --summary "Team Meeting" --start_time "2026-03-10T14:00:00-08:00" --end_time "2026-03-10T15:00:00-08:00"

# Create an event with details
gsk calendar create \
  --summary "Q1 Planning" \
  --start_time "2026-03-15T09:00:00-08:00" \
  --end_time "2026-03-15T11:00:00-08:00" \
  --description "Quarterly planning session" \
  --location "Conference Room A" \
  --time_zone "America/Los_Angeles"

# Create an event with attendees (sends invitations)
gsk calendar create \
  --summary "Interview" \
  --start_time "2026-03-12T10:00:00-08:00" \
  --end_time "2026-03-12T11:00:00-08:00" \
  --attendees [email protected] [email protected]

# Create on a specific calendar account
gsk calendar create --summary "Personal Event" --start_time "..." --end_time "..." -a [email protected]

| Option | Default | Description | |--------|---------|-------------| | --summary <title> | — | Event title (required) | | --start_time <ISO8601> | — | Start time with timezone offset (required) | | --end_time <ISO8601> | — | End time with timezone offset (required) | | --description <text> | — | Event description | | --location <text> | — | Event location | | --attendees <emails...> | — | Attendee email address(es) (sends invitations) | | --time_zone <tz> | UTC | Timezone name (e.g., America/Los_Angeles) | | -a, --from_account <email> | — | Calendar account email (for multi-account) |

AI Phone Calls

call

Make an AI phone call on your behalf. The AI validates prerequisites, resolves contact info, and initiates the call.

# Call a business by phone number
gsk call "Pizza Hut" -c "+1-555-123-4567" -p "Check if they deliver to my area"

# Call a business by Google Maps place_id
gsk call "Joe's Pizza" -c "ChIJxxxxxxxx" --is_place_id -p "Reserve a table for 4"

# Dry run: validate and resolve contact info without initiating the call
gsk call "Pizza Hut" -c "+1-555-123-4567" -p "Check hours" --dry-run

| Option | Default | Description | |--------|---------|-------------| | <recipient> | — | Name of the person or business to call (required, positional) | | -c, --contact_info <value> | — | Phone number or Google Maps place_id (required) | | --is_place_id | false | Treat contact_info as a Google Maps place_id | | -p, --purpose <value> | — | Purpose of the call (required) | | --dry-run | — | Only validate and resolve contact info, do not initiate the call |

Social Media

Retrieve data from Twitter/X, Instagram, and Reddit. All social commands are grouped under gsk social.

social twitter

Search and retrieve data from Twitter/X. 12 actions available.

# Search tweets
gsk social twitter search_posts -q "artificial intelligence" --start_date 2026-03-01 --language en

# Search users
gsk social twitter search_users -q "openai" --limit 5

# Get tweets by a specific author
gsk social twitter get_posts_by_author -q "elonmusk" --start_date 2026-01-01

# Get tweets by IDs
gsk social twitter get_posts_by_ids --post_ids "123456789,987654321"

# Get user profile
gsk social twitter get_user -q "elonmusk"

# Get followers or following
gsk social twitter get_user_connections -q "elonmusk" --connection_type followers

# Get users by keywords (mentioned in tweets)
gsk social twitter get_users_by_keywords -q "machine learning" --start_date 2026-01-01

# Get comments on a tweet
gsk social twitter get_comments -p "123456789" --start_date 2026-03-01

# Get quotes of a tweet
gsk social twitter get_quotes -p "123456789"

# Get retweets of a tweet
gsk social twitter get_retweets -p "123456789"

# Get users who interacted with a tweet
gsk social twitter get_post_interacting_users -p "123456789" --interaction_type retweeters

# Count posts matching a query
gsk social twitter count_posts -q "AI" --start_date 2026-03-01 --end_date 2026-03-10

| Option | Default | Description | |--------|---------|-------------| | <action> | — | Action to perform (required, positional) | | -q, --query <text> | — | Search query, username, or identifier | | -p, --post_id <id> | — | Tweet/post ID | | --post_ids <ids> | — | Comma-separated tweet IDs | | --connection_type <type> | followers | followers or following | | --interaction_type <type> | retweeters | commenters, quoters, or retweeters | | --start_date <YYYY-MM-DD> | — | Start date filter | | --end_date <YYYY-MM-DD> | — | End date filter | | --language <code> | — | Language filter (e.g., en, zh) | | --limit <n> | — | Max number of results |

Actions: search_posts, search_users, get_posts_by_author, get_posts_by_ids, get_user, get_user_connections, get_users_by_keywords, get_comments, get_quotes, get_retweets, get_post_interacting_users, count_posts

social instagram

Search and retrieve data from Instagram. 9 actions available.

# Search posts
gsk social instagram search_posts -q "travel photography" --start_date 2026-01-01

# Search users
gsk social instagram search_users -q "natgeo" --limit 5

# Get posts by a specific user
gsk social instagram get_posts_by_user -q "natgeo" --start_date 2026-03-01

# Get posts by IDs
gsk social instagram get_posts_by_ids --post_ids "abc123,def456"

# Get user profile
gsk social instagram get_user -q "natgeo"

# Get followers or following
gsk social instagram get_user_connections -q "natgeo" --connection_type following

# Get users by keywords
gsk social instagram get_users_by_keywords -q "landscape photographer"

# Get comments on a post
gsk social instagram get_comments -p "abc123" --start_date 2026-03-01

# Get users who liked or commented on a post
gsk social instagram get_post_interacting_users -p "abc123" --interaction_type likers

| Option | Default | Description | |--------|---------|-------------| | <action> | — | Action to perform (required, positional) | | -q, --query <text> | — | Search query, username, or identifier | | -p, --post_id <id> | — | Post ID | | --post_ids <ids> | — | Comma-separated post IDs | | --connection_type <type> | followers | followers or following | | --interaction_type <type> | likers | likers or commenters | | --start_date <YYYY-MM-DD> | — | Start date filter | | --end_date <YYYY-MM-DD> | — | End date filter | | --limit <n> | — | Max number of results |

Actions: search_posts, search_users, get_posts_by_user, get_posts_by_ids, get_user, get_user_connections, get_users_by_keywords, get_comments, get_post_interacting_users

social reddit

Search and retrieve data from Reddit. 9 actions available.

# Search posts (with sort and time filters)
gsk social reddit search_posts -q "rust programming" --sort top --time week -s "programming"

# Search comments
gsk social reddit search_comments -q "async await" -s "rust"

# Search users
gsk social reddit search_users -q "spez" --limit 5

# Search subreddits
gsk social reddit search_subreddits -q "machine learning" --limit 10

# Get a post with its comments
gsk social reddit get_post_with_comments -p "1abc2de"

# Get subreddit info with recent posts
gsk social reddit get_subreddit_with_posts -q "programming"

# Get subreddits by keywords
gsk social reddit get_subreddits_by_keywords -q "artificial intelligence"

# Get user profile
gsk social reddit get_user -q "spez"

# Get users by keywords (active in discussions)
gsk social reddit get_users_by_keywords -q "neural networks" -s "MachineLearning"

| Option | Default | Description | |--------|---------|-------------| | <action> | — | Action to perform (required, positional) | | -q, --query <text> | — | Search query, username, or subreddit name | | -p, --post_id <id> | — | Post ID | | -s, --subreddit <name> | — | Subreddit name filter | | --sort <order> | — | Sort: relevance, hot, top, new, comments | | --time <range> | — | Time filter: hour, day, week, month, year, all | | --start_date <YYYY-MM-DD> | — | Start date filter | | --end_date <YYYY-MM-DD> | — | End date filter | | --limit <n> | — | Max number of results |

Actions: search_posts, search_comments, search_users, search_subreddits, get_post_with_comments, get_subreddit_with_posts, get_subreddits_by_keywords, get_user, get_users_by_keywords

Local File Handling

Most commands that accept URLs also accept local file paths. The CLI automatically uploads local files before passing them to the API:

# These are equivalent:
gsk analyze "Describe this" -i ./photo.jpg
gsk img "Enhance this" -i ./photo.png -o ./result.png
gsk video "Animate this" -i ./frame.jpg -o ./video.mp4

Use -o / --output-file to save generated results directly to a local file.

Auto-Update

The CLI checks for updates every 4 hours and installs new versions in the background.

To disable auto-update:

# Via environment variable
export GSK_NO_AUTO_UPDATE=1

# Via config file
# Add "auto_update": false to ~/.genspark-tool-cli/config.json

Output Conventions

| Stream | Content | Consumer | |--------|---------|----------| | stdout | JSON result | Programs / AI agents | | stderr | Progress, debug, error messages | Human / logs |

This separation allows programs to parse clean JSON from stdout while humans can follow progress on stderr.

License

MIT