Ink Wordle

Terminal Wordle built with Ink.

Guess the five-letter word in six tries. After each guess, tiles are coloured: green = right letter, right spot; yellow = right letter, wrong spot; gray = not in the word. Duplicate letters are scored exactly like the original game.

Install

Requires Node 20+.

npx @terminalgames/ink-wordle

Global install

npm install -g @terminalgames/ink-wordle
ink-wordle

Modes

| Command | What you get | | --- | --- | | ink-wordle | Today's daily puzzle (same answer for everyone, by UTC date) | | ink-wordle --daily | Same as above | | ink-wordle --practice | A random word every launch | | ink-wordle --seed 42 | A specific, reproducible puzzle | | ink-wordle --help | Usage |

Controls

Because every letter has to reach the grid, the n/d/q shortcuts only act once the round is over. While playing, type your guess and submit it.

| Key | Action | | --- | --- | | a–z | Type a letter | | enter | Submit guess | | backspace | Delete a letter | | ? | Toggle help | | esc / Ctrl-C | Quit | | n | New practice game (after the round ends) | | d | Today's daily (after the round ends) | | q | Quit (after the round ends) |

The sidebar shows the current mode, guesses used, and session stats (played / won / lost and your win streak). Stats live for the session only — they are not written to disk.

Word list

The bundled word list is the well-known public Wordle list — 2,315 possible answers plus 10,657 additional accepted guesses (12,972 valid words total), redistributed from community mirrors. Answers are drawn from the answer pool; any of the 12,972 words is accepted as a guess.

Development

npm install
npm run build
node dist/cli.js

npm test
npm run typecheck

Game logic lives in pure TypeScript modules under src/game/; Ink UI is under src/ui/. The generated word arrays are in src/game/words/.

Publish

Maintainers only. Requires access to the @terminalgames npm organization:

npm login
npm publish --access public