codex-image-to-eagle git:20260427.eff932fA

Immutable. This exact content is served forever at /api/v1/blob/78ef443e02a2f997.

---
name: codex-image-to-eagle
description: Archive Codex-generated images from the current user's Codex generated_images directory into Eagle with the prompt saved as annotation. Use when the user asks to save, archive, import, or sync Codex generated images to Eagle with prompts, tags, and folders.
allowed-tools: Bash(node *)
---

# 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://localhost:41596`
- 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`

## Script

Use the bundled script:

```bash
node scripts/archive-codex-image-to-eagle.js --latest --prompt "PROMPT_TEXT"
```

Common options:

```bash
# Import the newest Codex-generated image.
node scripts/archive-codex-image-to-eagle.js --latest --prompt "PROMPT_TEXT"

# Override the Codex generated image directory when needed.
node scripts/archive-codex-image-to-eagle.js --latest --image-dir "~/.codex/generated_images" --prompt "PROMPT_TEXT"

# Import all image files in the newest generated_images session folder.
node scripts/archive-codex-image-to-eagle.js --latest-session --prompt "PROMPT_TEXT"

# Import a specific file.
node scripts/archive-codex-image-to-eagle.js --path "/absolute/path/image.png" --prompt "PROMPT_TEXT"

# Read a long prompt from a file.
node scripts/archive-codex-image-to-eagle.js --latest --prompt-file "/absolute/path/prompt.txt"

# Choose a target Eagle folder by name or ID.
node scripts/archive-codex-image-to-eagle.js --latest --folder-name "Codex 生成图" --prompt "PROMPT_TEXT"
node scripts/archive-codex-image-to-eagle.js --latest --folder-id "FOLDER_ID" --prompt "PROMPT_TEXT"

# Disable date subfolders and import into the root folder directly.
node scripts/archive-codex-image-to-eagle.js --latest --no-date-subfolders --prompt "PROMPT_TEXT"

# Preview without modifying Eagle.
node scripts/archive-codex-image-to-eagle.js --latest --prompt "PROMPT_TEXT" --dry-run
```

## Workflow

1. Identify the image path.
   - If the user refers to the latest generated image, use `--latest`.
   - If a generation produced multiple images, use `--latest-session`.
   - If the user provides a path, use `--path`.
2. Capture the final prompt exactly as used to generate the image.
3. Run the script with the prompt.
4. Return the imported Eagle item ID(s) and the folder used.

## Prompt annotation format

The script writes this structure into Eagle `annotation`:

```text
Prompt:
...

Archive:
- source: Codex
- original_path: ...
- archived_at: ...
```

## Safety

- Do not delete or move source files in the Codex generated images directory.
- Use `--dry-run` first when the prompt, folder, or image selection is uncertain.
- If Eagle is not running or the MCP plugin is disabled, ask the user to start Eagle and enable Eagle MCP.