Skip to main content

​
Skills + CLI

Use the official CLI to run DumplingAI directly from your terminal.

​
Install

npm install -g dumplingai-cli
dumplingai init
init walks through authentication and can install agent skills in the same flow.

​
Authenticate

dumplingai login --api-key sk_yourkey
Then confirm setup: 
dumplingai status

​
Common commands

CommandDescription
dumplingai initInteractive setup (auth + optional skill install)
dumplingai scrape <url>Scrape a page (markdown, html, or screenshot)
dumplingai search <query>Web search shortcut (auto-routes to search web)
dumplingai search news <query>News search
dumplingai search places <query>Google Places search
dumplingai search maps <query>Google Maps search
dumplingai search reviews <keyword>Google reviews for a business
dumplingai search autocomplete <query>Search suggestions
dumplingai transcript <url>YouTube/TikTok transcript
dumplingai env pullWrite API key into .env
dumplingai setup skillInstall DumplingAI skill files for agent environments
dumplingai view-configPrint resolved configuration
dumplingai versionPrint CLI version

​
Examples

# Scrape and print markdown
dumplingai scrape https://docs.example.com

# Scrape and save as JSON
dumplingai scrape https://example.com --json -o output.json

# Web search (shortcut)
dumplingai search "TypeScript 5.9 release notes"

# Explicit search subcommand
dumplingai search web "best React state management libraries" --scrape

# Fetch transcript
dumplingai transcript https://youtube.com/watch?v=dQw4w9WgXcQ --timestamps

​
Output and automation tips

  • Use -o <file> to save large output instead of printing to stdout.
  • Use --json when piping into scripts or other CLI tools.
  • You can pass a URL directly without scrape:
dumplingai https://example.com/article

​
Agent skills

The CLI can install skill files for supported coding agents so they use dumplingai consistently.

​
Install

dumplingai setup skill
You can also run dumplingai init and install skills during setup.

​
Optional flags

  • dumplingai setup skill --all: install into all supported environments, even if not detected.
  • dumplingai setup skill --dir <path>: install to a custom directory.

​
Supported environments

When detected in your current workspace, skill files are installed to:
  • ./.claude/skills/dumplingai-cli (Claude Code)
  • ./.cursor/skills/dumplingai-cli (Cursor)
  • ./.codex/skills/dumplingai-cli (Codex)

​
What gets installed

  • SKILL.md
  • rules/safety.md
  • rules/install.md
These files define allowed commands, escalation order (search -> scrape -> transcript), output hygiene, and safety rules for untrusted web content.

​
Validate installation

dumplingai setup skill --all
ls -la ./.codex/skills/dumplingai-cli

​
Next steps