gooseworks

GooseWorks

Give your coding agent (Claude Code, Cursor, Codex) access to 100+ data tools — scrape Twitter/Reddit/LinkedIn, find emails, enrich companies, research competitors — with one install.

Install

Pick your agent:

# Claude Code
npx gooseworks install --claude
npx gooseworks install --claude --with goose-graphics

# Cursor
npx gooseworks install --cursor

# Codex
npx gooseworks install --codex

# All detected agents
npx gooseworks install --all

This does three things:

1. Opens browser for Google sign-in
2. Installs the GooseWorks skill into your coding agent
3. You're ready — ask your agent to "scrape reddit", "find leads", "research competitors"

Use --with <skill-slug> to install standalone GooseWorks skills alongside the main GooseWorks skill. For example, --with goose-graphics installs /goose-graphics locally so your agent can run it directly without doing a catalog lookup through /gooseworks.

Other install methods

# Via Vercel skills.sh
npx skills add gooseworks-ai/gooseworks

# Via Claude Code plugins
/plugin install gooseworks

# Via OpenClaw ClawHub
clawhub skill install gooseworks

# Via Codex (OpenAI) — available once merged into openai/skills
codex skills install gooseworks

Commands

install

Full setup: login + install skill + configure your coding agent.

npx gooseworks install --claude    # Configure for Claude Code
npx gooseworks install --cursor    # Configure for Cursor
npx gooseworks install --codex     # Configure for Codex
npx gooseworks install --all       # Configure all detected agents
npx gooseworks install --claude --with goose-graphics
npx gooseworks install --claude --with goose-graphics --with aeo

What it does:

• Runs login if you don't have credentials yet
• Writes the GooseWorks skill to ~/.agents/skills/gooseworks/SKILL.md
• Downloads any --with standalone skills from gooseworks-ai/goose-skills into ~/.agents/skills/<slug>/
• Creates symlinks in ~/.claude/skills/ (Claude) or ~/.codex/skills/ (Codex), or writes MCP config (Cursor)

--with is repeatable. Unknown slugs are reported clearly and do not block the main GooseWorks skill install.

login

Authenticate with GooseWorks via Google OAuth.

npx gooseworks login

Flow:

1. Starts a temporary HTTP server on a random local port
2. Opens your browser to the GooseWorks sign-in page
3. You sign in with Google
4. Token saved to ~/.gooseworks/credentials.json

Timeout: 120 seconds. If the browser doesn't complete, re-run the command.

logout

Clear saved credentials.

npx gooseworks logout

Deletes ~/.gooseworks/credentials.json.

search

Search the GooseWorks skill catalog.

npx gooseworks search "reddit scraping"
npx gooseworks search "find emails"
npx gooseworks search "competitor research"

credits

Check your credit balance.

npx gooseworks credits

Output:

Credits: 847 available (500 subscription + 347 purchased)

update

Re-fetch the latest skill without re-authenticating.

npx gooseworks update

How It Works

1. Install — authenticates you and installs a master skill file into your coding agent
2. Ask your agent anything — "scrape r/ClaudeAI", "find CTOs at AI startups", "research competitor pricing"
3. Agent finds the right skill — searches the GooseWorks catalog of 100+ skills
4. Runs it — downloads and executes the skill's Python scripts, which call GooseWorks APIs
5. You get results — structured data returned directly in your coding agent

Standalone skills installed with --with skip the catalog search step. After npx gooseworks install --claude --with goose-graphics, you can invoke /goose-graphics ... directly from Claude Code.

Security & data handling

We'd rather you know exactly what this CLI does before you run it: