- 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 <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 10Tool 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_selectedOrganize 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"}'