README
¶
🔗 memelink-cli - Memes from the terminal
Generate memes from the terminal using the Memegen.link API.
Agent Skill
This CLI is available as an open agent skill for AI assistants including Claude Code, OpenClaw, Codex, Cursor, GitHub Copilot, and 35+ agents.
npx skills add dedene/memelink-cli
Install
Homebrew:
brew install dedene/tap/memelink-cli
Go:
go install github.com/dedene/memelink-cli/cmd/memelink@latest
Binary: download from Releases.
Quick start
# Auto-generate — API picks the best template
memelink "One does not simply mass produce memes"
# Template-based — specify template ID + text lines
memelink drake "Writing memes by hand" "Using memelink"
# Custom background
memelink custom --background https://example.com/photo.jpg "Top text" "Bottom text"
# Browse templates interactively (TUI picker)
memelink templates
Commands
| Command | Aliases | Description |
|---|---|---|
generate |
gen, g |
Generate a meme (default command) |
templates |
ls |
List templates or launch interactive picker |
fonts |
List available fonts | |
config |
Manage configuration | |
version |
Print version info |
generate is the default — bare memelink "text" works without typing it.
Generate flags
| Flag | Short | Description |
|---|---|---|
--format |
-f |
Image format: jpg, png, gif, webp |
--font |
Font ID or alias | |
--layout |
Text layout: default, top | |
--text-color |
Text color per line (repeatable) | |
--style |
Style name or overlay URL (repeatable) | |
--width |
Image width in pixels | |
--height |
Image height in pixels | |
--safe |
Filter NSFW content | |
--background |
Background image URL (with custom template) |
|
--copy |
-c |
Copy URL to clipboard |
--open |
-o |
Open URL in browser |
--output |
Download image to file path | |
-O |
Download with auto-generated filename | |
--preview / --no-preview |
Inline image preview (on by default in TTY) |
Configuration
Config file: ~/.config/memelink/config.json (JSON5 readable).
memelink config set default_format png
memelink config get default_format
memelink config unset default_format
memelink config list
memelink config path
| Key | Values | Description |
|---|---|---|
default_format |
jpg, png, gif, webp | Default image format |
default_font |
any font ID | Default font |
default_layout |
default, top | Default text layout |
safe |
true, false | Filter NSFW content |
auto_copy |
true, false | Auto-copy URL to clipboard |
auto_open |
true, false | Auto-open URL in browser |
preview |
true, false | Inline image preview |
cache_ttl |
Go duration (e.g. 12h) |
Template cache lifetime (default 24h) |
Interactive mode
When stdout is a TTY, memelink templates launches a fuzzy-search picker. Select a template, enter
text for each line, and the meme URL is printed to stdout.
Inline image preview renders in terminals that support it (iTerm2, Kitty, Sixel). Disable with
--no-preview or memelink config set preview false.
Global flags
| Flag | Description |
|---|---|
--json |
JSON output |
--color |
Color output: auto, always, never |
--verbose |
Verbose logging |
--no-input |
Never prompt; fail instead |
--force |
Skip confirmations |
--version |
Print version and exit |
Environment
| Variable | Description |
|---|---|
MEMEGEN_API_KEY |
API key for authenticated Memegen.link access (optional) |
License
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
memelink
command
Package main is the entry point for the memelink CLI.
|
Package main is the entry point for the memelink CLI. |
|
internal
|
|
|
actions
Package actions provides post-generation output actions: clipboard copy, browser open, and file download.
|
Package actions provides post-generation output actions: clipboard copy, browser open, and file download. |
|
api
Package api provides an HTTP client for the Memegen.link API.
|
Package api provides an HTTP client for the Memegen.link API. |
|
cache
Package cache provides file-based template caching with TTL support.
|
Package cache provides file-based template caching with TTL support. |
|
cmd
Package cmd implements the memelink CLI commands and Kong parser setup.
|
Package cmd implements the memelink CLI commands and Kong parser setup. |
|
config
Package config manages user preferences stored as JSON5/JSON files.
|
Package config manages user preferences stored as JSON5/JSON files. |
|
encoding
Package encoding provides Memegen text encoding and decoding.
|
Package encoding provides Memegen text encoding and decoding. |
|
outfmt
Package outfmt provides context-based output mode selection (JSON vs human).
|
Package outfmt provides context-based output mode selection (JSON vs human). |
|
preview
Package preview renders inline terminal image previews.
|
Package preview renders inline terminal image previews. |
|
tui
Package tui provides the interactive Bubbletea TUI for template selection and meme generation.
|
Package tui provides the interactive Bubbletea TUI for template selection and meme generation. |
|
ui
Package ui provides terminal output writers with color profile support.
|
Package ui provides terminal output writers with color profile support. |
Click to show internal directories.
Click to hide internal directories.