Codex Image to Eagle

Archive images generated by Codex into Eagle and preserve the prompt as searchable metadata.

Default behavior

Image source: CODEX_GENERATED_IMAGES_DIR if set, otherwise <current user home>/.codex/generated_images
Eagle connection: local Eagle MCP server on http://127.0.0.1:41596 by default. Prefer the IPv4 loopback address over localhost to avoid IPv6/hostname resolution issues.
Stdio mode: the script reads the current user's ~/.codex/config.toml, prefers [mcp_servers.eagle], and can auto-detect other Eagle-like stdio MCP entries. Use --transport http to force the legacy HTTP path.
Import method: Eagle MCP item_add
Prompt storage: Eagle item annotation
Default tags: Codex, AI生成, Prompt
Default folder: use the folder requested by the user as the root; if none is specified, create or reuse Codex 生成图
Default organization: put each image into a local-date subfolder under the root, e.g. Codex 生成图/2026-4-26
Folder safety: resolve folders by exact parent-child path, not by name alone. Folder creation is guarded by a local lock to avoid duplicate date folders when several automation jobs run at the same time.

Use the bundled script: