PuzzleTide Puzzle Generator

PuzzleTide CLI — Wortsuch-, Kreuzworträtsel- & Sudoku-Generator

Wortsuch-Generator, Kreuzworträtsel-Generator und Sudoku-Generator + -Löser in einem lokal-first Puzzle-Generator-CLI — mit druckbaren PDF-Arbeitsblättern, Starter- Wortlisten, verifizierbaren LLM-Evaluierungen und gebündelten Agenten-Fähigkeiten. Von den Machern von puzzletide.com.

Installation

npm install -g puzzletide
ptide --version

Das Paket installiert beide Binärdateien:

• ptide
• puzzletide

Warum Puzzles mit einem CLI generieren?

Bitten Sie ein Sprachmodell, eine Wortsuche zu schreiben, und Sie erhalten ein Gitter, in dem die Hälfte der Wörter fehlerhaft ist; bitten Sie es um ein Sudoku, und Sie erhalten normalerweise eines mit mehreren Lösungen oder gar keiner. Gitter sind genau die Art von Ausgabe, in der LLMs schlecht sind und deterministischer Code gut ist.

PuzzleTide CLI ist dieser deterministische Code:

• Jedes Wort in der Wortsuche ist platziert und verifizierbar — Platzierungskoordinaten sind Teil der Ausgabe, und die Generatoren sind eigenschaftsgetestet.
• Jedes generierte Sudoku wird daraufhin überprüft, genau eine Lösung zu haben.
• Jedes Kreuzworträtsel wird anhand seiner eigenen Hinweise validiert, bevor es zurückgegeben wird.
• Gleicher --seed rein, gleiches Puzzle raus, auf jeder Maschine.

Das Paket enthält auch SKILL.md Agenten-Fähigkeiten, sodass Coding-Agenten (Pi, Hermes, OpenClaw und andere SKILL.md-basierte Systeme) zum CLI greifen, anstatt Gitter von Hand zu schreiben.

Befehlsmodell

ptide <namespace> <operation> [input] [options]   # for humans
ptide run <tool-id> [input] [options] --json      # canonical, for scripts/agents
ptide tools list | search <q> | info <id> | docs <id>
ptide agent manifest

Verwenden Sie kurze Befehle interaktiv und kanonische Tool-IDs in der Automatisierung:

ptide sudoku generate --difficulty hard
ptide run puzzle.sudoku.generate --difficulty hard --json

Wortsuch-Generator

Acht Platzierungsrichtungen mit Voreinstellungen für einfach/mittel/schwer, automatisch dimensionierte Gitter (6–30), Normalisierung von Akzenten/Leerzeichen/Bindestrichen. Wörter stammen aus Flags, Dateien oder gebündelten Themen:

# Word search from your own words, printed in the terminal
ptide wordsearch generate --words "coral,shark,kelp,wave,tide"

# Themed printable word search (puzzle page + solution page)
ptide wordsearch generate --theme animals/ocean-animals --pdf ocean.pdf

# Kids mode: easy = forward-only words
ptide wordsearch generate --theme seasonal/halloween --difficulty easy

Kreuzworträtsel-Generator

Ineinandergreifende Platzierung mit standardmäßiger Kreuzworträtsel-Nummerierung, Hinweis-Gitter- Validierung und deterministischen Fallback-Hinweisen für Themenwörter. Wörter, die nicht ineinandergreifen können, werden gemeldet, anstatt stillschweigend fallengelassen zu werden:

# Crossword with your clues
ptide crossword generate --words "PARIS: Capital of France; TOKYO: Capital of Japan"

# From a JSON file, as a printable PDF
ptide crossword generate --file words.json --pdf review.pdf --title "Unit 4 Review"

Sudoku-Generator und -Löser

Einfache, mittlere, schwere und Experten-Sudokus (17–21 Vorgaben) mit einer Eindeutigkeits- garantie, einem sofortigen Löser und einem Validierer, der Konflikte, Lösbarkeit und Lösungseindeutigkeit meldet:

ptide sudoku generate --difficulty expert --seed 42
ptide sudoku solve "53..7....6..195....98....6.8...6...34..8.3..17...2...6.6....28....419..5....8..79"
ptide sudoku validate --file puzzle.txt
ptide daily        # today's daily sudoku, same for everyone on a given UTC day

Druckbare Puzzles: PDF-Arbeitsblätter und SVG

Jeder Generator akzeptiert --pdf <file> für ein druckfertiges Arbeitsblatt — Puzzle- Seite(n) plus eine Lösungsseite (--paper letter|a4, Lösungsschlüssel weglassen mit --no-solution-page) — und --svg <file> für Vektorbilder. Druckbare Wortsuch- und druckbare Sudoku-Blätter für ein Klassenzimmer-Paket sind nur eine Schleife entfernt:

for i in 1 2 3 4 5; do
  ptide sudoku generate --difficulty medium --seed "$i" --pdf "sudoku-$i.pdf" --title "Sudoku #$i"
done

Bevorzugen Sie fertige Blätter? Die druckbare Wortsuche zu Mysterien und Mord ist ein Leserliebling, mit Hunderten weiteren unter druckbare Puzzles.

Wortlisten und Wortwerkzeuge

30 Starter-Themen (Meerestiere, Früchte, Weltraum, Halloween, ...) — durchsuchen, suchen, Musterabgleich, Anagramme, Zufallsauswahl. Bringen Sie Ihre eigenen Listen über --words/--file mit oder spielen Sie die vollständig kuratierte Sammlung auf puzzletide.com:

ptide words themes --search dinosaur
ptide words match "c_r_l"        # crossword-style pattern matching
ptide words anagram coral

Es gibt auch ein Galgenmännchen-Spiel im Terminal: ptide play hangman.

Agenten-Fähigkeiten

Pi kann die gebündelten Fähigkeiten direkt aus diesem npm-Paket laden:

pi install npm:puzzletide

Das Paketmanifest deklariert:

{
  "pi": {
    "skills": ["./skills"]
  }
}

Fünf Fähigkeiten sind enthalten: Wortsuche, Kreuzworträtsel, Sudoku, druckbare Puzzles und Agenten-Evaluierungen. Jede bevorzugt das lokale CLI und prüft ptide, puzzletide, dann npx puzzletide. Fähigkeiten installieren niemals automatisch etwas; Agenten sollten den Benutzer vor der Installation fragen.

MCP-Server für Claude Desktop, Cursor und jeden MCP-Client

Das Begleitpaket puzzletide-mcp stellt jedes nicht-interaktive Tool über das Model Context Protocol bereit — denselben Wortsuch-Generator, Kreuzworträtsel-Generator, Sudoku-Generator/-Löser, Wort- werkzeuge und Evaluierungen, aufrufbar von Claude Desktop, Cursor, Windsurf oder jedem MCP- Client:

{
  "mcpServers": {
    "puzzletide": {
      "command": "npx",
      "args": ["-y", "puzzletide-mcp"]
    }
  }
}

Siehe docs/mcp.md für Tool-Namen, Argumente und die Einrichtung pro Client.

Werkzeuge

Der MCP-Server (und ptide run <tool-id>) stellt 15 Werkzeuge bereit:

• puzzle_wordsearch_generate: Generiert ein Wortsuchgitter aus benutzerdefinierten Wörtern, Dateien oder thematischen Wortlisten — jede Platzierung verifizierbar, druckbar über PDF/SVG.
• puzzle_crossword_generate: Generiert ein ineinandergreifendes Kreuzworträtsel mit Standardnummerierung und validierten Hinweisen.
• puzzle_sudoku_generate: Generiert einfache, mittlere, schwere oder Experten-Sudokus mit garantiert eindeutiger Lösung.
• puzzle_sudoku_solve: Löst ein Sudoku aus seiner 81-stelligen Zeichenkette und meldet, ob die Lösung eindeutig ist.
• puzzle_sudoku_validate: Validiert ein Sudoku-Gitter — Konflikte, Lösbarkeit und Lösungseindeutigkeit.
• words_categories: Listet Wortlisten-Kategorien auf.
• words_themes: Listet die gebündelten thematischen Wortlisten auf oder durchsucht sie.
• words_list: Listet die Wörter in einem Thema, gefiltert nach Länge oder Anzahl.
• words_match: Findet Wörter, die einem Kreuzworträtsel-ähnlichen Muster entsprechen (c_r_l).
• words_anagram: Findet Anagramme der angegebenen Buchstaben in der Wortliste.
• words_random: Wählt ein zufälliges Wort aus, optional aus einem Thema.
• words_stats: Wortlisten-Statistiken.
• eval_generate: Generiert reproduzierbare, objektiv bewertbare Puzzle-Aufgaben zum Benchmarking von LLMs und Agenten.
• eval_check: Bewertet Antworten auf generierte Evaluierungsaufgaben konstruktionsbedingt — kein Antwortschlüssel erforderlich.
• play_daily: Gibt das tägliche Sudoku des Tages aus (für alle an einem UTC-Tag gleich).

Verifizierbare LLM-Evaluierungen

Puzzle-Antworten sind ohne Antwortschlüssel überprüfbar: Eine Sudoku-Antwort erfüllt entweder die Regeln und bewahrt die Vorgaben oder nicht; eine Wortsuch- Antwort buchstabiert das Wort entweder entlang einer geraden Linie im Gitter oder nicht. Das macht Puzzles zu sauberen Benchmark-Aufgaben für LLM-Evaluierungen — kein LLM- Richter erforderlich:

ptide eval generate --type sudoku --n 20 --difficulty hard --seed 1 --out tasks.json
# ...run your model on tasks.json, collect [{id, answer}] ...
ptide eval check --tasks tasks.json --answers answers.json --json

Das Tupel (Typ, Schwierigkeit, n, Seed) bestimmt vollständig den Aufgabensatz, sodass es einen reproduzierbaren Benchmark benennt.

Bibliotheksnutzung

Die Engines sind als TypeScript importierbar, ohne CLI-Beteiligung:

import { generateSudoku, generateWordSearch, wordSearchPdf } from 'puzzletide';

const sudoku = generateSudoku({ difficulty: 'hard', seed: 42 });
const search = generateWordSearch({
  words: ['coral', 'shark', 'kelp'],
  directions: ['E', 'S', 'SE'],
  seed: 7,
});
const pdfBytes = await wordSearchPdf(search, { title: 'Ocean Animals' });

Weitere Dokumentation:

• CLI-Befehle
• Tool-Registry
• Agenten-Fähigkeiten

Online-Versionen

Bevorzugen Sie einen Browser?

• PuzzleTide Wortsuche
• PuzzleTide Kreuzworträtsel
• PuzzleTide Sudoku
• PuzzleTide Galgenmännchen
• Druckbare Puzzles
• Eigenes Puzzle erstellen
• Legasthenie-freundliche Wortsuch-Schriftarten und -Einstellungen

Datenschutz

Alles läuft lokal. Kein Konto, kein API-Schlüssel, keine Telemetrie, kein Netzwerkzugriff.

Entwicklung

npm install
npm run build     # tsc → dist/
npm test          # vitest + fast-check property tests (build first: CLI tests run dist/)

Die Starter-Wortlisten sind generische, originelle Listen, die für dieses Paket geschrieben wurden (scripts/wordbanks-source.json, kompiliert mit npm run build:wordbanks). Themenbeiträge sind willkommen — fügen Sie einen Eintrag zur Quelldatei hinzu und führen Sie den Build aus. Die vollständige kuratierte PuzzleTide-Wortlistensammlung ist proprietär für puzzletide.com und nicht Teil dieses Repositorys.

PuzzleTide CLI zitieren

Wenn Sie PuzzleTide CLI in Ihrer Arbeit verwenden — zum Beispiel die verifizierbaren Puzzle- Evaluierungen in einem Modell-Benchmark — zitieren Sie es bitte (oder verwenden Sie GitHubs Schaltfläche „Dieses Repository zitieren“):

@software{puzzletide_cli,
  author  = {{Caravaca Labs}},
  title   = {PuzzleTide CLI: word search, crossword \& sudoku generator with verifiable LLM evals},
  year    = {2026},
  url     = {https://github.com/Caravaca-Labs/puzzletide-cli},
  note    = {From the makers of \url{https://puzzletide.com}}
}

Klartext: "PuzzleTide CLI (Caravaca Labs, 2026), https://github.com/Caravaca-Labs/puzzletide-cli — von den Machern von https://puzzletide.com."

Lizenz

MIT © Caravaca Labs