Eagle Skill

---

name: eagle description: 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. allowed-tools: Bash(node *)

---

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  --json '{"key": "value"}'
Call a tool with individual parameters
node scripts/eagle-api-cli.js call  --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 

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

Eagle application must be running

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