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"}'