setup-earl

Install and configure the Earl CLI for agent API access.

112|7|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/brwse/earl --skill setup-earl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-earl
Source: https://github.com/brwse/earl/tree/main/skills/development/setup-earl
Command: npx skills add https://github.com/brwse/earl --skill setup-earl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a repeatable, secure onboarding flow that installs the Earl CLI and configures agent platforms so agents call vetted templates instead of raw CLI tools, preventing accidental credential exposure and unsafe tool use.

Core Features & Use Cases

  • Automated Installation: Detects OS environment and installs Earl, with fallbacks to the project install script when prerequisites are missing.
  • Immediate Demo: Imports and runs a no-auth demo template so the user sees a working example right away.
  • Agent Integration: Detects Claude Code, Claude Desktop, Cursor, and Windsurf configurations and merges an Earl MCP server into their MCP JSON or instructs manual application when necessary.
  • Onboarding & Migration: Writes CLAUDE.md breadcrumbs, offers migration from curl/gh/stripe-cli calls, and can create new Earl templates or invoke migration helpers.
  • Security Controls: Emphasizes OS keychain secrets, supports OAuth modes appropriate to agents, and provides an optional lockdown step to prevent bypassing Earl.

Quick Start

Run the setup-earl skill to install Earl, import a demo template, configure MCP for your agent platform, and choose to migrate existing CLI calls or create new templates.

Frequently Asked Questions about setup-earl

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I secure agent access to external APIs and command-line tools?

The Earl CLI secures agent access by routing calls through vetted templates instead of raw CLI tools, preventing accidental credential exposure and unsafe command execution.

How do I configure MCP JSON for Claude Code, Cursor, or Windsurf agents?

The setup process detects your agent platform and automatically merges an Earl MCP server into the MCP JSON configuration, or instructs manual application when auto-merging is not possible.

Can I migrate existing curl, gh, or stripe-cli calls to use secure templates?

Yes, the onboarding flow offers migration from curl, gh, and stripe-cli calls by replacing raw commands with Earl templates, and can invoke migration helpers or create new templates as needed.

How does Earl handle OAuth flows and API secrets securely?

Earl handles secrets securely by storing them in the OS keychain and supports OAuth modes appropriate to your agent, ensuring credentials are never exposed in plaintext configuration files.

What happens during Earl CLI installation if prerequisites are missing?

During installation, the setup detects the OS environment and installs Earl with fallbacks to the project install script when prerequisites are missing, then imports a no-auth demo template.