makememe 0.1.0__tar.gz

makememe-0.1.0/.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(cp -r /Users/dhruvmehra/Desktop/Claude/Life/tools/meme/skill/meme ~/.claude/skills/meme)",
+      "Read(//Users/dhruvmehra/.claude/skills/**)",
+      "Read(//Users/dhruvmehra/.claude/skills/meme/**)"
+    ]
+  }
+}

makememe-0.1.0/.gitignore

@@ -0,0 +1,18 @@
+# build artifacts
+dist/
+build/
+*.egg-info/
+__pycache__/
+*.pyc
+
+# default meme output
+meme.png
+*.png
+*.jpg
+*.webp
+*.gif
+!docs/**/*.png
+
+# envs
+.venv/
+venv/

makememe-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dhruv Mehra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

makememe-0.1.0/PKG-INFO

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: makememe
+Version: 0.1.0
+Summary: A tiny zero-dependency CLI for generating memes via the free memegen.link API. Agent-friendly.
+Project-URL: Homepage, https://pypi.org/project/makememe/
+Project-URL: memegen.link API, https://api.memegen.link
+Author: Dhruv Mehra
+License: MIT
+License-File: LICENSE
+Keywords: agent,claude,cli,codex,meme,memegen
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# meme
+
+A tiny, zero-dependency CLI for generating memes via the free
+[memegen.link](https://memegen.link) API. No API key, no signup, stdlib-only.
+
+Built to be **agent-friendly**: predictable stdout, a `--json` mode, and a
+bundled Claude Code skill so coding agents (Claude Code, Codex, etc.) can drive
+it directly.
+
+```bash
+meme drake "not reading docs" "reading docs" -o out.png
+```
+
+## Install
+
+Requires Python 3.8+.
+
+```bash
+pip install makememe
+# or, as an isolated tool:
+uv tool install makememe      # or: pipx install makememe
+```
+
+Run once without installing:
+
+```bash
+uvx --from makememe meme drake "a" "b"
+```
+
+## Usage
+
+```bash
+meme <template> "top line" "bottom line" [-o out.png]
+```
+
+| Flag | Meaning |
+|------|---------|
+| `-o, --out` | output file (default `meme.png`) |
+| `--bg URL` | use a custom background image instead of a template |
+| `--ext` | `png` (default), `jpg`, `webp`, or `gif` |
+| `--style` / `--font` | template style variant / font override |
+| `--print-url` | print the image URL, don't download |
+| `--json` | machine-readable output (for scripts/agents) |
+| `--list` | list available template ids |
+
+### Examples
+
+```bash
+meme drake "manual deploys" "ci/cd"
+meme same "after I sold" "if I held" "same picture"
+meme --bg https://example.com/pic.png "_" "DODGED"
+meme regret "SOLD @ 620" "NOW 780 (+26%)" --print-url
+meme --list
+meme --list --json
+```
+
+### Text that starts with `-`
+
+If a caption line begins with `-` (e.g. `"-26%"`), put `--` before your lines so
+it isn't parsed as a flag:
+
+```bash
+meme regret --json -- "-26%" "WHY"
+```
+
+(Put flags like `--json`/`-o` *before* the `--`.)
+
+## For agents (Claude Code / Codex / scripts)
+
+The tool is designed to be parsed:
+
+- **Plain mode** prints *only the output path* to stdout (status goes to stderr),
+  so `path=$(meme drake "a" "b")` just works.
+- **`--json` mode** prints a single JSON object:
+
+  ```json
+  { "path": "meme.png", "bytes": 12345, "url": "https://api.memegen.link/..." }
+  ```
+
+  `--list --json` returns the template catalog as JSON; `--print-url --json`
+  returns `{"url": "..."}`; failures return `{"error": "...", "url": "..."}`
+  with a non-zero exit code.
+
+Typical agent flow:
+
+```bash
+meme --list --json                       # discover template ids
+meme drake "old way" "new way" --json    # generate, capture the path
+```
+
+### Claude Code skill
+
+A ready-made skill lives in [`skill/meme/`](skill/meme/SKILL.md). Install it so
+Claude Code auto-discovers the tool:
+
+```bash
+# user-level (all projects)
+mkdir -p ~/.claude/skills
+cp -r skill/meme ~/.claude/skills/meme
+
+# or project-level
+mkdir -p .claude/skills
+cp -r skill/meme .claude/skills/meme
+```
+
+Then just ask Claude Code things like *"make a drake meme about writing tests"*
+and it will call `meme` for you.
+
+## Robustness
+
+The CLI is built to fail gracefully, never with a raw traceback:
+
+- Network errors, dead hosts, bad template ids (404), oversized text (414), and
+  non-image backgrounds (415) all exit non-zero with a one-line message — and
+  **no partial/garbage file is written**.
+- `Ctrl-C` exits cleanly (code 130); piping into `head` etc. won't spew a
+  `BrokenPipeError`.
+- Arbitrary text — emoji, CJK, `% # & / ? " \`, tabs, control chars, 10k-char
+  lines — is escaped safely.
+
+Run the test suite (stdlib only, no network needed):
+
+```bash
+python -m unittest discover -s tests
+```
+
+## How it works
+
+It builds a memegen.link URL from your template + text (handling all the fiddly
+path-segment escaping — spaces, `_`, `-`, `?`, `/`, `%`, etc.), downloads the
+image, and saves it. That's the whole trick.
+
+## License
+
+MIT

makememe-0.1.0/README.md

@@ -0,0 +1,135 @@
+# meme
+
+A tiny, zero-dependency CLI for generating memes via the free
+[memegen.link](https://memegen.link) API. No API key, no signup, stdlib-only.
+
+Built to be **agent-friendly**: predictable stdout, a `--json` mode, and a
+bundled Claude Code skill so coding agents (Claude Code, Codex, etc.) can drive
+it directly.
+
+```bash
+meme drake "not reading docs" "reading docs" -o out.png
+```
+
+## Install
+
+Requires Python 3.8+.
+
+```bash
+pip install makememe
+# or, as an isolated tool:
+uv tool install makememe      # or: pipx install makememe
+```
+
+Run once without installing:
+
+```bash
+uvx --from makememe meme drake "a" "b"
+```
+
+## Usage
+
+```bash
+meme <template> "top line" "bottom line" [-o out.png]
+```
+
+| Flag | Meaning |
+|------|---------|
+| `-o, --out` | output file (default `meme.png`) |
+| `--bg URL` | use a custom background image instead of a template |
+| `--ext` | `png` (default), `jpg`, `webp`, or `gif` |
+| `--style` / `--font` | template style variant / font override |
+| `--print-url` | print the image URL, don't download |
+| `--json` | machine-readable output (for scripts/agents) |
+| `--list` | list available template ids |
+
+### Examples
+
+```bash
+meme drake "manual deploys" "ci/cd"
+meme same "after I sold" "if I held" "same picture"
+meme --bg https://example.com/pic.png "_" "DODGED"
+meme regret "SOLD @ 620" "NOW 780 (+26%)" --print-url
+meme --list
+meme --list --json
+```
+
+### Text that starts with `-`
+
+If a caption line begins with `-` (e.g. `"-26%"`), put `--` before your lines so
+it isn't parsed as a flag:
+
+```bash
+meme regret --json -- "-26%" "WHY"
+```
+
+(Put flags like `--json`/`-o` *before* the `--`.)
+
+## For agents (Claude Code / Codex / scripts)
+
+The tool is designed to be parsed:
+
+- **Plain mode** prints *only the output path* to stdout (status goes to stderr),
+  so `path=$(meme drake "a" "b")` just works.
+- **`--json` mode** prints a single JSON object:
+
+  ```json
+  { "path": "meme.png", "bytes": 12345, "url": "https://api.memegen.link/..." }
+  ```
+
+  `--list --json` returns the template catalog as JSON; `--print-url --json`
+  returns `{"url": "..."}`; failures return `{"error": "...", "url": "..."}`
+  with a non-zero exit code.
+
+Typical agent flow:
+
+```bash
+meme --list --json                       # discover template ids
+meme drake "old way" "new way" --json    # generate, capture the path
+```
+
+### Claude Code skill
+
+A ready-made skill lives in [`skill/meme/`](skill/meme/SKILL.md). Install it so
+Claude Code auto-discovers the tool:
+
+```bash
+# user-level (all projects)
+mkdir -p ~/.claude/skills
+cp -r skill/meme ~/.claude/skills/meme
+
+# or project-level
+mkdir -p .claude/skills
+cp -r skill/meme .claude/skills/meme
+```
+
+Then just ask Claude Code things like *"make a drake meme about writing tests"*
+and it will call `meme` for you.
+
+## Robustness
+
+The CLI is built to fail gracefully, never with a raw traceback:
+
+- Network errors, dead hosts, bad template ids (404), oversized text (414), and
+  non-image backgrounds (415) all exit non-zero with a one-line message — and
+  **no partial/garbage file is written**.
+- `Ctrl-C` exits cleanly (code 130); piping into `head` etc. won't spew a
+  `BrokenPipeError`.
+- Arbitrary text — emoji, CJK, `% # & / ? " \`, tabs, control chars, 10k-char
+  lines — is escaped safely.
+
+Run the test suite (stdlib only, no network needed):
+
+```bash
+python -m unittest discover -s tests
+```
+
+## How it works
+
+It builds a memegen.link URL from your template + text (handling all the fiddly
+path-segment escaping — spaces, `_`, `-`, `?`, `/`, `%`, etc.), downloads the
+image, and saves it. That's the whole trick.
+
+## License
+
+MIT

makememe-0.1.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "makememe"
+version = "0.1.0"
+description = "A tiny zero-dependency CLI for generating memes via the free memegen.link API. Agent-friendly."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "Dhruv Mehra" }]
+keywords = ["meme", "cli", "memegen", "agent", "claude", "codex"]
+classifiers = [
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Multimedia :: Graphics",
+    "Topic :: Utilities",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://pypi.org/project/makememe/"
+"memegen.link API" = "https://api.memegen.link"
+
+[project.scripts]
+meme = "memecli.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/memecli"]

makememe-0.1.0/skill/meme/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: meme
+description: Generate meme images from a template and caption text using the `meme` CLI (a wrapper over the free memegen.link API). Use whenever the user asks to make/create/generate a meme, add a caption to a meme template, or wants a funny image with top/bottom text. Handles popular templates (drake, distracted boyfriend, two buttons, etc.) and custom background images.
+---
+
+# meme
+
+Generate memes from the command line. The `meme` command wraps the free
+[memegen.link](https://api.memegen.link) API — no API key needed.
+
+## Prerequisite
+
+The `meme` command must be installed. Check with `meme --list`. If it's missing,
+install it:
+
+```bash
+pip install makememe
+# or: uv tool install makememe
+```
+
+## Workflow
+
+1. **Pick a template.** If you don't already know a valid template id, list them:
+
+   ```bash
+   meme --list --json
+   ```
+
+   Common ids: `drake`, `db` (distracted boyfriend), `buttons` (two buttons),
+   `gru` (gru's plan), `cmm` (change my mind), `fine` (this is fine),
+   `success` (success kid), `rollsafe`, `same` (same picture), `regret`.
+
+2. **Generate.** Pass the template id then the caption lines in order. Use
+   `--json` so you can capture the output path reliably:
+
+   ```bash
+   meme drake "writing code by hand" "asking the meme cli" --json
+   ```
+
+   Output:
+
+   ```json
+   { "path": "meme.png", "bytes": 12345, "url": "https://api.memegen.link/..." }
+   ```
+
+3. **Tell the user the path** (and show the image if the surface supports it).
+
+## Key flags
+
+- `-o out.png` — choose the output filename (default `meme.png`). Pick a
+  descriptive name when generating several.
+- `--bg <image-url>` — use a custom background image instead of a template;
+  pass caption lines as usual.
+- `--ext png|jpg|webp|gif` — output format.
+- `--print-url` — get the image URL without downloading.
+- `--json` — machine-readable output (always prefer this when scripting).
+
+## Tips
+
+- Number of caption lines depends on the template (`--list` shows each
+  template's `lines` count). Most use 2 (top/bottom).
+- For an empty line, pass `"_"` (memegen renders it blank).
+- Text escaping (spaces, `?`, `/`, `%`, emoji, etc.) is handled automatically —
+  just pass natural text in quotes.
+- If a caption line starts with `-` (e.g. `"-26%"`), insert `--` before the
+  lines so it isn't read as a flag: `meme regret --json -- "-26%" "WHY"`.
+  (Flags like `--json`/`-o` go before the `--`.)
+- If a download fails, the JSON output includes the `url` and `error` — inspect
+  the URL to debug the template id or line count.
+
+## Examples
+
+```bash
+meme drake "old way" "new way" -o drake.png --json
+meme same "after I sold" "if I held" "same picture" --json
+meme cmm "tabs are better than spaces" --json
+meme --bg https://example.com/cat.png "_" "DEPLOY ON FRIDAY" --json
+```

makememe-0.1.0/src/memecli/__init__.py

@@ -0,0 +1,6 @@
+"""meme - a tiny zero-dependency CLI over the free memegen.link API."""
+
+from .cli import build_url, download, escape, get_templates, main
+
+__version__ = "0.1.0"
+__all__ = ["main", "build_url", "escape", "download", "get_templates", "__version__"]

makememe-0.1.0/src/memecli/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    main()

makememe-0.1.0/src/memecli/cli.py

@@ -0,0 +1,180 @@
+#!/usr/bin/env python3
+"""
+meme - a tiny CLI over the free memegen.link API.
+
+Builds a meme image URL from a template + text lines, downloads it, saves an
+image. No API key, no third-party dependencies (Python stdlib only). Handles URL
+escaping so you never hit the bare-% problem.
+
+Examples:
+    meme drake "not reading docs" "reading docs"
+    meme regret "SOLD IRCTC @ Rs620" "NOW Rs780 (+26%) WHY"
+    meme same "after I sold" "if I held" "same picture"
+    meme --bg https://example.com/pic.png "_" "DODGED"
+    meme drake "a" "b" --print-url        # just print the URL, don't download
+    meme drake "a" "b" --json             # machine-readable output for agents
+    meme --list                           # list available template ids
+    meme --list --json                    # template ids as JSON
+
+Find templates: https://api.memegen.link/templates/  (or `meme --list`)
+"""
+
+import argparse
+import json
+import os
+import sys
+import urllib.parse
+import urllib.request
+
+API = "https://api.memegen.link"
+
+
+# memegen path-segment escaping. Order matters: escape the escape chars first.
+# Confirmed from the API: space->_, _->__, -->--, ?->~q, newline->~n, "->''
+# Others use memegen's documented tilde codes; verify with --print-url if unsure.
+def escape(text):
+    if text == "":
+        return "_"  # memegen renders an empty line as a single underscore
+    text = text.replace("_", "__").replace("-", "--")
+    text = text.replace(" ", "_").replace("\n", "~n")
+    text = text.replace("?", "~q").replace('"', "''").replace("/", "~s")
+    # let quote percent-encode the rest (%, #, etc) - memegen decodes %25 reliably.
+    # keep the memegen tokens we just produced intact.
+    return urllib.parse.quote(text, safe="_~'.!*()")
+
+
+def build_url(template, lines, ext="png", bg=None, style=None, font=None):
+    parts = [escape(l) for l in lines] if lines else ["_"]
+    base = "custom" if bg else template
+    path = "/".join(parts)
+    url = f"{API}/images/{base}/{path}.{ext}"
+    q = {}
+    if bg:
+        q["background"] = bg
+    if style:
+        q["style"] = style
+    if font:
+        q["font"] = font
+    if q:
+        url += "?" + urllib.parse.urlencode(q)
+    return url
+
+
+def get_templates(timeout=20):
+    req = urllib.request.Request(
+        f"{API}/templates/", headers={"User-Agent": "meme-cli"})
+    with urllib.request.urlopen(req, timeout=timeout) as r:
+        return json.load(r)
+
+
+def list_templates(as_json=False):
+    data = get_templates()
+    if as_json:
+        slim = [
+            {"id": t["id"], "lines": t.get("lines"), "name": t["name"]}
+            for t in data
+        ]
+        print(json.dumps(slim, indent=2))
+        return
+    for t in data:
+        print(f"{t['id']:<18} {t.get('lines', '?')} lines  {t['name']}")
+
+
+def download(url, out, timeout=30):
+    req = urllib.request.Request(url, headers={"User-Agent": "meme-cli"})
+    with urllib.request.urlopen(req, timeout=timeout) as r:
+        data = r.read()
+    with open(out, "wb") as f:
+        f.write(data)
+    return len(data)
+
+
+def build_parser():
+    ap = argparse.ArgumentParser(
+        prog="meme", description="Generate a meme via memegen.link.",
+        epilog="Tip: if a text line starts with '-' (e.g. \"-26%\"), put '--' "
+               "before your lines so it isn't read as a flag:\n"
+               "  meme regret --json -- \"-26%\" \"WHY\"",
+        formatter_class=argparse.RawDescriptionHelpFormatter)
+    ap.add_argument("template", nargs="?",
+                    help="template id (see --list), or any id when using --bg")
+    ap.add_argument("lines", nargs="*", help="text lines, in order")
+    ap.add_argument("-o", "--out", default="meme.png",
+                    help="output file (default meme.png)")
+    ap.add_argument("--bg",
+                    help="custom background image URL (uses the 'custom' template)")
+    ap.add_argument("--ext", default="png", choices=["png", "jpg", "webp", "gif"])
+    ap.add_argument("--style", help="template style variant, if any")
+    ap.add_argument("--font", help="font name (see /fonts/)")
+    ap.add_argument("--print-url", action="store_true",
+                    help="print the URL and exit, no download")
+    ap.add_argument("--json", action="store_true",
+                    help="emit machine-readable JSON (good for agents/scripts)")
+    ap.add_argument("--list", action="store_true",
+                    help="list template ids and exit")
+    return ap
+
+
+def _run(argv=None):
+    ap = build_parser()
+    args = ap.parse_args(argv)
+
+    if args.list:
+        try:
+            list_templates(as_json=args.json)
+        except Exception as e:
+            sys.exit(f"could not fetch templates: {e}")
+        return
+
+    if not args.template and not args.bg:
+        ap.error("a template id is required (or use --bg for a custom background)")
+
+    # with --bg there is no template positional, so fold it back into the lines
+    if args.bg:
+        lines = ([args.template] if args.template else []) + args.lines
+        template = "custom"
+    else:
+        lines = args.lines
+        template = args.template
+
+    url = build_url(template, lines, args.ext, args.bg, args.style, args.font)
+
+    if args.print_url:
+        if args.json:
+            print(json.dumps({"url": url}))
+        else:
+            print(url)
+        return
+
+    try:
+        n = download(url, args.out)
+    except Exception as e:
+        if args.json:
+            print(json.dumps({"error": str(e), "url": url}))
+            sys.exit(1)
+        sys.exit(f"download failed: {e}\nurl was: {url}")
+
+    if args.json:
+        print(json.dumps({"path": args.out, "bytes": n, "url": url}))
+    else:
+        print(args.out)                   # stdout: just the path, easy to capture
+        print(f"saved {n} bytes from {url}", file=sys.stderr)
+
+
+def main(argv=None):
+    """Entry point. Wraps _run so the CLI never dies with a raw traceback."""
+    try:
+        return _run(argv)
+    except KeyboardInterrupt:
+        print("interrupted", file=sys.stderr)
+        sys.exit(130)
+    except BrokenPipeError:
+        # downstream closed the pipe (e.g. `meme --list | head`). Silence the
+        # traceback Python would otherwise emit when flushing stdout at exit.
+        devnull = os.open(os.devnull, os.O_WRONLY)
+        os.dup2(devnull, sys.stdout.fileno())
+        sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

makememe-0.1.0/tests/test_cli.py

@@ -0,0 +1,106 @@
+"""Offline tests for meme's URL building / escaping and crash-safety.
+
+Run with:  python -m unittest discover -s tests
+No network access required (network paths are covered by --print-url style asserts).
+"""
+
+import io
+import unittest
+from contextlib import redirect_stderr, redirect_stdout
+
+from memecli import cli
+
+
+class TestEscape(unittest.TestCase):
+    def test_empty_is_underscore(self):
+        self.assertEqual(cli.escape(""), "_")
+
+    def test_space(self):
+        self.assertEqual(cli.escape("a b"), "a_b")
+
+    def test_literal_underscore_and_dash(self):
+        self.assertEqual(cli.escape("a_b"), "a__b")
+        self.assertEqual(cli.escape("a-b"), "a--b")
+
+    def test_special_tokens(self):
+        self.assertEqual(cli.escape("really?"), "really~q")
+        self.assertEqual(cli.escape("a/b"), "a~sb")
+        self.assertEqual(cli.escape('say "hi"'), "say_''hi''")
+
+    def test_percent_and_hash_are_encoded_not_dropped(self):
+        # the bare-% problem: must be percent-encoded, never left raw
+        self.assertEqual(cli.escape("50%"), "50%25")
+        self.assertIn("%23", cli.escape("#tag"))
+
+    def test_unicode_roundtrips_to_ascii_url(self):
+        out = cli.escape("café 🚀")
+        self.assertTrue(out.isascii(), "URL segment must be ascii-safe")
+
+    def test_no_input_ever_raises(self):
+        for s in ["", " ", "\n", "\t", "\x07", "%%%", "----", "____",
+                  "a" * 10000, "🚀" * 100, "?/\"\\#&=+"]:
+            cli.escape(s)  # should not raise
+
+
+class TestBuildUrl(unittest.TestCase):
+    def test_basic(self):
+        u = cli.build_url("drake", ["a b", "c"])
+        self.assertEqual(u, "https://api.memegen.link/images/drake/a_b/c.png")
+
+    def test_no_lines_gives_single_underscore(self):
+        u = cli.build_url("drake", [])
+        self.assertTrue(u.endswith("/drake/_.png"))
+
+    def test_custom_background(self):
+        u = cli.build_url("x", ["t"], bg="https://e.com/p.png")
+        self.assertIn("/images/custom/", u)
+        self.assertIn("background=https%3A%2F%2Fe.com%2Fp.png", u)
+
+    def test_ext_and_style_and_font(self):
+        u = cli.build_url("drake", ["a"], ext="jpg", style="s", font="impact")
+        self.assertIn(".jpg?", u)
+        self.assertIn("style=s", u)
+        self.assertIn("font=impact", u)
+
+
+class TestCrashSafety(unittest.TestCase):
+    """The CLI must exit cleanly, never propagate a raw exception."""
+
+    def _exit_code(self, argv):
+        try:
+            cli.main(argv)
+            return 0
+        except SystemExit as e:
+            return e.code if isinstance(e.code, int) else 1
+
+    def test_missing_template_is_clean_exit(self):
+        with redirect_stderr(io.StringIO()):
+            self.assertEqual(self._exit_code([]), 2)
+
+    def test_print_url_no_network(self):
+        buf = io.StringIO()
+        with redirect_stdout(buf):
+            cli.main(["drake", "a", "b", "--print-url"])
+        self.assertIn("api.memegen.link/images/drake/a/b.png", buf.getvalue())
+
+    def test_keyboard_interrupt_becomes_130(self):
+        orig = cli.download
+        cli.download = lambda *a, **k: (_ for _ in ()).throw(KeyboardInterrupt())
+        try:
+            with redirect_stderr(io.StringIO()):
+                self.assertEqual(self._exit_code(["drake", "a", "b"]), 130)
+        finally:
+            cli.download = orig
+
+    def test_download_failure_is_clean_exit_in_json(self):
+        orig = cli.download
+        cli.download = lambda *a, **k: (_ for _ in ()).throw(OSError("boom"))
+        try:
+            with redirect_stdout(io.StringIO()), redirect_stderr(io.StringIO()):
+                self.assertEqual(self._exit_code(["drake", "a", "--json"]), 1)
+        finally:
+            cli.download = orig
+
+
+if __name__ == "__main__":
+    unittest.main()