---

name: sudoku description: Fetch Sudoku puzzles and store them as JSON in the workspace; render images on demand; reveal solutions later. metadata: clawdbot: emoji: "🧩" requires: bins: ["python3", "node"]

Sudoku

Overview

Fetch, render, and reveal Sudoku puzzles. Use sudoku.py to get new puzzles from sudokuonline.io, generate printable PDFs or images, and reveal solutions.

Get a Puzzle

Fetches a new puzzle and stores it as JSON. Output is JSON by default (use --text for human-readable output).

Get a Classic Easy puzzle:

Copy./sudoku.py get easy9

Get a Kids 6x6 puzzle:

Copy./sudoku.py get kids6

Render Puzzle

Render a puzzle as an image or PDF.

Render latest puzzle as A4 PDF (for printing):

Copy./sudoku.py render --pdf

Render latest puzzle as clean PNG (for viewing):

Copy./sudoku.py render

Render a specific previous puzzle by short ID:

Copy./sudoku.py render --id a09f3680

Reveal Solution

Reveal the solution for the latest or specific puzzle.

Reveal full solution as printable PDF:

Copy./sudoku.py reveal --pdf

Reveal full solution as PNG image:

Copy./sudoku.py reveal

Reveal a single cell (row 3, column 7):

Copy./sudoku.py reveal --cell 3 7

Reveal a specific 3x3 box (index 5):

Copy./sudoku.py reveal --box 5

Share Link

Generate a share link for a stored puzzle.

Generate a SudokuPad share link (default):

Copy./sudoku.py share

Generate an SCL share link:

Copy./sudoku.py share --type scl

Telegram Formatting Tip: Format links as a short button-style link and hide the full URL: [Easy Classic \[<id>\]](<url>).