Skip to main content
The GooseWorks CLI installs the GooseWorks skill catalog into your coding agent (Claude Code, Cursor, Codex). A master skill file teaches your agent how to search and run 100+ ready-made skills — Reddit / X / LinkedIn scraping, email finding, prospect enrichment, competitor research, and more. Each skill run is credit-billed.
CLI vs MCP. The CLI and the GooseWorks MCP server are two different things. The CLI installs local skill files. The MCP provides account tools for files, chat history, automations, and Ad Remixer, and can also return skill instructions on demand through search_skills and fetch_skill. You can use the MCP without local skill files, or install both — npx gooseworks install --mcp (or --all) installs the skills and registers the MCP server in the same step as a convenience.

​
Install

By default, this command installs only the GooseWorks skill into your coding agent. The skill teaches your agent how to search the catalog and run any of the 100+ data skills on demand. If you also want to register the GooseWorks MCP server, pass the flag explicitly — see Install flags below. What a default install does:
  1. Opens your browser to sign in with Google
  2. Installs the GooseWorks skill to ~/.agents/skills/gooseworks/
  3. Symlinks / references it so your coding agent can discover it
  4. Saves your credentials to ~/.gooseworks/credentials.json

​
Install flags

The CLI exposes one MCP server you can opt into: Combine it with any agent flag:
--all implies --mcp, and runs across every coding agent detected on your machine. The --mcp flag supports Claude Code, Cursor, and Codex. For Codex it writes the gooseworks server entry to ~/.codex/config.toml; restart Codex after installation so the new connection is loaded. See MCP Servers for what each MCP provides.

​
What happens after install

Your coding agent gets a new skill that teaches it how to use the full GooseWorks toolkit. When you ask it to do any data task — scraping, research, lead generation, enrichment — it will automatically search the GooseWorks skill catalog, fetch the right skill, and run it. If you registered the MCP server (via --mcp or --all), the agent also gets direct tool access to files, chat history, automations, and Ad Remixer. It can call search_skills and fetch_skill to load GooseWorks instructions on demand, even if a specific skill such as goose-video is not installed locally. Example prompts you can try:
  • “Scrape the top posts from r/ClaudeAI on Reddit”
  • “Find the email address for the CEO of Acme Corp”
  • “Research competitors of Linear.app”
  • “List the files in my agent workspace” (requires --mcp)
  • “What did my agent and I talk about last week?” (requires --mcp)
  • “Create a daily automation at 9am that pulls new Linear issues into my workspace” (requires --mcp)

​
Commands

​
How skills run

When your coding agent uses a GooseWorks skill:
  1. It searches the skill catalog to find the right skill for your task
  2. It downloads the skill’s instructions and scripts
  3. It saves scripts to a temporary directory (never your project folder)
  4. It runs the scripts with the right parameters
  5. API calls go through GooseWorks proxy — you never need to manage API keys

​
Credits

Each skill run costs credits. You start with 200 free credits when you sign up. Check your balance anytime:
You can top up credits from the Settings page in the web dashboard.

​
Credentials

Your login credentials are stored at ~/.gooseworks/credentials.json. This file contains your API key, email, the API base URL, and (if the backend provides it) mcp_server_url for the GooseWorks MCP server. To switch accounts or environments, log out and log back in: