Package Exports

@genspark/cli
@genspark/cli/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@genspark/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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, 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
🤖 Agents	Podcasts, docs, slides, deep research, websites, batch media generation
🔊 Voice	Voice cloning, voice changer

Installation
Quick Start
Authentication
Commands
Available Models
Configuration
Output Conventions
License

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

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"

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 (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 (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 (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

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

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

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"

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

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 user@gmail.com

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 user@gmail.com

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:boss@company.com 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 recipient@example.com --subject "Hello" --body "Hi there!"

# Send to multiple recipients
gsk email send --to "alice@example.com,bob@example.com" --subject "Team Update" --body "..."

# Send HTML email
gsk email send --to user@example.com --subject "Newsletter" --body "<h1>Title</h1><p>...</p>" --content_type text/html

# Send with CC and BCC
gsk email send --to recipient@example.com --subject "Meeting" --body "..." --cc manager@company.com --bcc archive@company.com

# Send from a specific account
gsk email send --to user@example.com --subject "Hi" --body "..." -a sender@gmail.com

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 user@gmail.com

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 candidate@example.com interviewer@company.com

# Create on a specific calendar account
gsk calendar create --summary "Personal Event" --start_time "..." --end_time "..." -a user@gmail.com

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)

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

@genspark/cli