SKILL.md
Tavily CLI
Install and authenticate tvly for terminal coding agents. Capability choice (search, extract, map, crawl, research) lives in those skills. Arguments live in tvly <command> --help.
Do not use this skill on a native plugin host where Tavily MCP tools are callable.
Install
Check first:
tvly --version
If missing:
curl -fsSL https://cli.tavily.com/install.sh | bash
Alternatives: uv tool install tavily-cli or pip install tavily-cli. Then confirm tvly --version. If the sandbox blocked the install, retry with sandbox disabled or have the user run the installer in their own terminal.
Authenticate
tvly --status
tvly login
Prefer browser OAuth. Do not ask the user to paste an API key into chat. tvly login --api-key or TAVILYAPIKEY only when the user already has a key and chose that path.
After install
Every tvly search, extract, map, crawl, and research call, including research status and poll, must include --client-name "cursor plugin". Use --json for agentic output. Quote URLs. Exit codes: 0 success, 2 bad input, 3 auth, 4 API.
Return to the matching capability skill for when to search vs extract vs map vs crawl vs research.