Earl

earl Plugin

Secure CLI proxy for AI agents — secrets stay in OS keychain, never in tool arguments.

Commands

Templates

• earl template import — Import a provider template

Secrets

• earl secret set — Store a secret in OS keychain

Calling

• earl call --yes --json — Call a template command

Usage Examples

• "Import GitHub template and call search_repos"
• "Store API token securely"
• "Set up MCP tools for Claude Code"

Installation

curl -fsSL https://raw.githubusercontent.com/mathematic-inc/earl/main/scripts/install.sh | bash

Examples

# Import a template
earl templates import https://raw.githubusercontent.com/mathematic-inc/earl/main/examples/github.hcl

# Store a secret
earl secrets set github.token

# Call a command
earl call --yes --json github.search_repos --query "language:rust stars:>100"

# MCP setup for Claude Code
# Add to MCP config:
# { "mcpServers": { "earl": { "command": "earl", "args": ["mcp", "stdio"] } } }

Key Features

• HCL-defined operation templates
• OS keychain secrets storage
• MCP integration
• Prompt injection protection
• Supports HTTP, GraphQL, gRPC, Bash, SQL