@10xdevs/ogee

Generate a clean Open Graph image for a Next.js app with one command.

@10xdevs/ogee is a focused CLI that:

1. starts your app with npm run dev when needed
2. reuses an already running app when the target port is live
3. captures a production-ready OG image with agent-browser
4. writes the result to app/opengraph-image.png

Why

Open Graph images are repetitive setup work. ogee is meant to remove that friction for Next.js projects and give you a solid default path:

• fixed output path: app/opengraph-image.png
• fixed OG size: 1200x630
• PNG output for best image quality
• no prompts for save path or aspect ratio

Usage

npx @10xdevs/ogee

If your app is already running on another port:

npx @10xdevs/ogee --port 3001

What It Does

When you run ogee, it:

1. checks whether your app is already reachable
2. starts npm run dev if it is not
3. waits for the app to load
4. opens the app in agent-browser
5. captures the OG image
6. saves it to app/opengraph-image.png

Options

--port <port>          Use a different local port
--url <url>            Use a specific app URL
--wait <ms>            Wait a bit longer before capture
--keep-server          Leave the dev server running after capture

Examples:

npx @10xdevs/ogee --wait 3000
npx @10xdevs/ogee --keep-server
npx @10xdevs/ogee --port 3001

Requirements

• Node.js 20+
• a Next.js app with npm run dev
• npx available in your environment

Output

ogee always writes the generated image to:

app/opengraph-image.png

That matches the standard Next.js App Router OG image location.

Publish

npm publish --access public