Eagle Skill

Control Eagle application for digital asset management - search, organize, tag items, manage folders and tag groups. Use when user wants to interact with their Eagle library, search for images, manage tags or folders.

Eagle API Skill

Control the local Eagle application through CLI commands. Eagle is a digital asset management tool for organizing images, videos, fonts, and design files.

Prerequisites

• Eagle application must be running
• Eagle MCP plugin must be enabled (provides the local API server on port 41596)

CLI Usage

The CLI script is located at scripts/eagle-api-cli.js relative to this skill directory.

# Call a tool with JSON parameters
node scripts/eagle-api-cli.js call <tool_name> --json '{"key": "value"}'

# Call a tool with individual parameters
node scripts/eagle-api-cli.js call <tool_name> --param1 value1 --param2 value2

# List all available tools
node scripts/eagle-api-cli.js list

# Get help for a specific tool
node scripts/eagle-api-cli.js help <tool_name>

Array and object values are auto-parsed from JSON:

node scripts/eagle-api-cli.js call item_get --tags '["photo","landscape"]' --limit 10

Tool Categories

Choose the relevant reference file for detailed tool documentation:

• App — Get Eagle app info (version, platform, locale). See references/app-tools.md
• Item — Search, filter, add, update, tag, and organize library items. See references/item-tools.md
• Folder — Create, query, and update folder hierarchy. See references/folder-tools.md
• Tag — Query, count, rename, and merge tags. See references/tag-tools.md
• Tag Group — Manage tag groups and tag associations. See references/tag-group-tools.md
• AI Search — Semantic search by text or similar items (requires AI Search plugin). See references/ai-search-tools.md

Common Workflows

Search for items

# Text search
node scripts/eagle-api-cli.js call item_query --query "sunset landscape"

# Filter by tags and extension
node scripts/eagle-api-cli.js call item_get --tags '["photo"]' --ext "jpg" --limit 20

# Get selected items in Eagle
node scripts/eagle-api-cli.js call item_get_selected

Organize items

# Add tags to items
node scripts/eagle-api-cli.js call item_add_tags --json '{"ids": ["item1", "item2"], "tags": ["reviewed", "approved"]}'

# Move items to folders
node scripts/eagle-api-cli.js call item_add_to_folders --json '{"ids": ["item1"], "folders": ["folder_id"]}'

# Create a new folder
node scripts/eagle-api-cli.js call folder_create --json '{"folders": [{"name": "My Folder", "iconColor": "blue"}]}'

Tag management

# List all tags
node scripts/eagle-api-cli.js call tag_get

# Merge duplicate tags
node scripts/eagle-api-cli.js call tag_merge --json '{"sourceTags": ["photo", "photograph"], "targetTag": "photo"}'