PuzzleTide Puzzle Generator

PuzzleTide CLI — 단어 찾기, 십자말풀이 & 스도쿠 생성기

하나의 로컬 우선 퍼즐 생성 CLI에서 단어 찾기 생성기, 십자말풀이 생성기, 스도쿠 생성기 및 해결기를 제공하며, 인쇄 가능한 PDF 워크시트, 시작용 단어 은행, 검증 가능한 LLM 평가, 번들 에이전트 스킬을 포함합니다. puzzletide.com 제작.

설치

npm install -g puzzletide
ptide --version

패키지는 두 바이너리를 모두 설치합니다:

• ptide
• puzzletide

CLI로 퍼즐을 생성해야 하는 이유

언어 모델에 단어 찾기를 작성하라고 요청하면 단어의 절반이 깨진 그리드를 얻게 되고, 스도쿠를 요청하면 보통 여러 개의 해답이 있거나 아예 없는 퍼즐을 받게 됩니다. 그리드는 LLM이 취약하고 결정론적 코드가 강점을 보이는 바로 그런 종류의 출력입니다.

PuzzleTide CLI는 바로 그 결정론적 코드입니다:

• 모든 단어 찾기 단어는 배치되고 검증 가능합니다 — 배치 좌표가 출력의 일부이며, 생성기는 속성 테스트를 거쳤습니다.
• 생성된 모든 스도쿠는 정확히 하나의 해답만 가지는지 확인됩니다.
• 모든 십자말풀이는 반환되기 전에 자체 단서에 대해 검증됩니다.
• 동일한 --seed 입력 시, 어떤 기기에서든 동일한 퍼즐이 출력됩니다.

또한 이 패키지는 SKILL.md 에이전트 스킬을 제공하므로, 코딩 에이전트(Pi, Hermes, OpenClaw 및 기타 SKILL.md 기반 시스템)가 그리드를 직접 작성하는 대신 CLI를 사용합니다.

명령 모델

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

대화형으로는 짧은 명령을, 자동화에서는 표준 도구 ID를 사용하세요:

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

단어 찾기 생성기

쉬움/보통/어려움 사전 설정이 있는 8가지 배치 방향, 자동 크기 조정 그리드(6–30), 악센트/공백/하이픈 정규화. 단어는 플래그, 파일 또는 번들 테마에서 가져옵니다:

# 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

십자말풀이 생성기

표준 십자말풀이 번호 매기기를 통한 연동 배치, 단서-그리드 검증, 테마 단어에 대한 결정론적 대체 단서. 연동할 수 없는 단어는 조용히 누락되지 않고 보고됩니다:

# 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"

스도쿠 생성기 및 해결기

유일성 보장이 있는 쉬움, 보통, 어려움, 전문가용 스도쿠(17–21개 힌트), 즉시 해결기, 충돌, 해결 가능성 및 해답 유일성을 보고하는 검증기:

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

인쇄 가능한 퍼즐: PDF 워크시트 및 SVG

모든 생성기는 인쇄 가능한 워크시트를 위해 --pdf <file> 옵션을 지원합니다 — 퍼즐 페이지와 해답 페이지(--paper letter|a4, --no-solution-page로 해답 키 생략 가능) — 그리고 벡터 이미지를 위한 --svg <file> 옵션도 제공합니다. 교실용 인쇄 가능한 단어 찾기 및 스도쿠 시트는 루프 하나로 만들 수 있습니다:

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

미리 만들어진 시트를 원하시나요? 미스터리 및 살인 사건 인쇄용 단어 찾기는 독자들에게 인기가 많으며, 인쇄 가능한 퍼즐에서 더 많은 자료를 찾을 수 있습니다.

단어 은행 및 단어 도구

30개의 시작 테마(해양 동물, 과일, 우주, 할로윈 등) — 찾아보기, 검색, 패턴 일치, 애너그램, 무작위 선택. --words/--file을 통해 자신만의 목록을 가져오거나 puzzletide.com에서 전체 큐레이션 컬렉션을 이용할 수 있습니다:

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

터미널에서 즐기는 행맨 게임도 있습니다: ptide play hangman.

에이전트 스킬

Pi는 이 npm 패키지에서 번들 스킬을 직접 로드할 수 있습니다:

pi install npm:puzzletide

패키지 매니페스트 선언:

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

단어 찾기, 십자말풀이, 스도쿠, 인쇄 가능한 퍼즐, 에이전트 평가의 5가지 스킬이 포함되어 있습니다. 각 스킬은 로컬 CLI를 선호하며 ptide, puzzletide, 그다음 npx puzzletide를 확인합니다. 스킬은 절대 자동으로 설치되지 않으며, 에이전트는 설치 전에 사용자에게 문의해야 합니다.

Claude Desktop, Cursor 및 모든 MCP 클라이언트를 위한 MCP 서버

동반 패키지 puzzletide-mcp는 모델 컨텍스트 프로토콜을 통해 모든 비대화형 도구를 노출합니다 — 동일한 단어 찾기 생성기, 십자말풀이 생성기, 스도쿠 생성기/해결기, 단어 도구 및 평가를 Claude Desktop, Cursor, Windsurf 또는 모든 MCP 클라이언트에서 호출할 수 있습니다:

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

도구 이름, 인수 및 클라이언트별 설정은 docs/mcp.md를 참조하세요.

도구

MCP 서버(및 ptide run <tool-id>)는 15개의 도구를 노출합니다:

• puzzle_wordsearch_generate: 사용자 정의 단어, 파일 또는 테마 단어 은행에서 단어 찾기 그리드를 생성합니다 — 모든 배치가 검증 가능하며 PDF/SVG로 인쇄 가능합니다.
• puzzle_crossword_generate: 표준 번호 매기기와 검증된 단서로 연동되는 십자말풀이를 생성합니다.
• puzzle_sudoku_generate: 유일한 해답이 보장된 쉬움, 보통, 어려움 또는 전문가용 스도쿠를 생성합니다.
• puzzle_sudoku_solve: 81자 문자열에서 스도쿠를 풀고 해답이 유일한지 보고합니다.
• puzzle_sudoku_validate: 스도쿠 그리드의 충돌, 해결 가능성 및 해답 유일성을 검증합니다.
• words_categories: 단어 은행 카테고리를 나열합니다.
• words_themes: 번들 테마 단어 목록을 나열하거나 검색합니다.
• words_list: 길이나 개수로 필터링하여 테마의 단어를 나열합니다.
• words_match: 십자말풀이 스타일 패턴(c_r_l)과 일치하는 단어를 찾습니다.
• words_anagram: 단어 은행에서 주어진 문자로 된 애너그램을 찾습니다.
• words_random: 선택적으로 하나의 테마에서 무작위 단어를 선택합니다.
• words_stats: 단어 은행 통계.
• eval_generate: LLM 및 에이전트 벤치마킹을 위해 재현 가능하고 객관적으로 채점 가능한 퍼즐 작업을 생성합니다.
• eval_check: 생성된 평가 작업에 대한 답변을 구성별로 채점합니다 — 해답 키를 신뢰하지 않습니다.
• play_daily: 오늘의 일일 스도쿠를 인쇄합니다(UTC 날짜 기준 모두에게 동일).

검증 가능한 LLM 평가

퍼즐 답변은 해답 키 없이도 확인할 수 있습니다: 스도쿠 답변은 규칙을 만족하고 주어진 숫자를 보존하거나 그렇지 않으며, 단어 찾기 답변은 그리드의 직선을 따라 단어를 철자하거나 그렇지 않습니다. 이는 퍼즐을 LLM 평가를 위한 깔끔한 벤치마크 작업으로 만듭니다 — LLM 심사위원이 필요 없습니다:

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

(유형, 난이도, n, 시드) 튜플이 작업 세트를 완전히 결정하므로, 재현 가능한 벤치마크의 이름이 됩니다.

라이브러리 사용

엔진은 CLI 없이 가져올 수 있는 TypeScript입니다:

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' });

더 많은 문서:

• CLI 명령
• 도구 레지스트리
• 에이전트 스킬

온라인 버전

브라우저를 선호하시나요?

• PuzzleTide 단어 찾기
• PuzzleTide 십자말풀이
• PuzzleTide 스도쿠
• PuzzleTide 행맨
• 인쇄 가능한 퍼즐
• 나만의 퍼즐 만들기
• 난독증 친화적 단어 찾기 글꼴 및 설정

개인정보 보호

모든 것이 로컬에서 실행됩니다. 계정, API 키, 원격 측정, 네트워크 액세스가 필요 없습니다.

개발

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

시작 단어 은행은 이 패키지를 위해 작성된 일반적인 오리지널 목록입니다(scripts/wordbanks-source.json, npm run build:wordbanks로 컴파일됨). 테마 기여를 환영합니다 — 소스 파일에 항목을 추가하고 빌드를 실행하세요. 전체 큐레이션된 PuzzleTide 단어 은행 컬렉션은 puzzletide.com의 독점 자산이며 이 저장소의 일부가 아닙니다.

PuzzleTide CLI 인용

모델 벤치마크에서 검증 가능한 퍼즐 평가 등 작업에 PuzzleTide CLI를 사용하는 경우 인용해 주시기 바랍니다(또는 GitHub의 "이 저장소 인용" 버튼 사용):

@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}}
}

일반 텍스트: "PuzzleTide CLI (Caravaca Labs, 2026), https://github.com/Caravaca-Labs/puzzletide-cli — https://puzzletide.com. 제작"

라이선스

MIT © Caravaca Labs