eagle

# 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. ```bash # 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: ```bash 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](references/app-tools.md) - **Item** — Search, filter, add, update, tag, and organize library items. See [references/item-tools.md](references/item-tools.md) - **Folder** — Create, query, and update folder hierarchy. See [references/folder-tools.md](references/folder-tools.md) - **Tag** — Query, count, rename, and merge tags. See [references/tag-tools.md](references/tag-tools.md) - **Tag Group** — Manage tag groups and tag associations. See [references/tag-group-tools.md](references/tag-group-tools.md) - **AI Search** — Semantic search by text or similar items (requires AI Search plugin). See [references/ai-search-tools.md](references/ai-search-tools.md) ## Common Workflows ### Search for items ```bash # 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 ```bash # 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 ```bash # 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"}' ```