MagicMeme CLI

MagicMeme CLI is a small Node.js 18+ program with no extra dependencies. It talks to the same public HTTP catalog as the hosted MCP server: GET https://magicmeme.com/api/memes. It then either lists matching template slugs and titles, or prints a /create URL with your situation in the query string. Humans open that link, edit captions, and download a PNG. The CLI does not render stills, does not call face swap, and does not download Chrome.

Install

The package lives in this repository at packages/cli under the npm name magicmeme. It is not claimed as already published. Once it is on npm, the intended install is npx magicmeme. Until then, run the bin from a clone.

npx magicmeme

# from a clone of this repo, before npm publish:
node packages/cli/magicmeme.js --help

Commands

No arguments or --help prints usage. search takes a query (format name, slug fragment, or keywords), fetches the catalog, and prints up to 25 matches as slug then title, tab-separated. url requires --prompt (3–2000 characters) and accepts optional --template with a catalog slug such as this-is-fine. The printed link is /create?prompt= plus encodeURIComponent, and &template= when you pass a slug.

magicmeme search drake
magicmeme url --prompt "9am standup on two hours of sleep"
magicmeme url --prompt "this PR is 47 nitpicks" --template this-is-fine
MAGICMEME_URL=http://localhost:3000 magicmeme search this is fine

Environment

Set MAGICMEME_URL to point catalog fetches and create links at another origin. The default origin is https://magicmeme.com. Point it at a local app (http://localhost:3000) without changing commands.

For agents

Prefer this CLI when you want a shell one-liner: look up a slug, or hand a human a studio URL. For pixels in chat, stills, captions, or paid face swap, use the MCP tools and HTTP API instead of this binary. Start with the agents guide, the machine-readable OpenAPI spec, and llms.txt.