Cluemaster

Cluemaster Studio

A harness for playing Codenames as the spymaster, with an AI assistant. Enter your board, pick a model, and every clue it suggests is checked against the rules before you see it.

Cluemaster Studio: the 5 by 5 board on the left, and the chat on the right with the clue estuary for river and mouth, followed by marking both words as found.
What it does

What it does

Your board

Enter it once. The model always has it.

Checked clues

Every clue is checked against the rules first.

Chat

Ask why, push back, ask for another.

Real games

Play as the spymaster, with the AI as your assistant.

An example turn

What happens when it gives a clue

One turn from a real example board. Bars are the guesser's expected finds out of 2.

01

Board

Word lists, what is revealed and the earlier clues go into the prompt.

MY TEAM
BUNK  CENTER
BAND  SNAKE
OPPONENT
MAKEUP
NEUTRAL
WELL KITCHEN
STATE HORSE
ASSASSIN
MICROWAVE
02

Candidates

The model proposes several clues, each with targets.

QUARTERS  2
 BUNK CENTER
ORCHESTRA 2
 BAND CENTER
RUBBER    2
 BAND SNAKE
STAGE     2
 BAND CENTER
03

Checks

Each candidate is tested against the rules.

QUARTERS   pass
ORCHESTRA  pass
RUBBER     pass
STAGE      pass

not a board word
not a form of one
targets are yours
number matches
04

Guesser

A guesser plays each clue against the board.

QUARTERS
████████░░░░ 1.3
ORCHESTRA
████████░░░░ 1.3
RUBBER
████████████ 2.0
STAGE
██████████░░ 1.7
risk: STATE, WELL,
MAKEUP
05

Clue

The best candidate is shown with its number.

RUBBER
2

words
BAND, SNAKE

found 2 of 2
risk: WELL (neutral)

The candidates and scores come from a training example, shown here as a sample turn.

Models

Bring your model

Switch provider and model in settings. API keys stay in a settings file on your computer.

Ollama

Local models on your own machine.

Needs Ollama running

llama.cpp

Local models through llama-server.

Needs llama-server running

OpenRouter

Hosted models, including Claude, GPT and Gemini, behind one key.

Needs an OpenRouter key

Limits

What to know

The guesser is a check

It is the spymaster model in a different role, so it is not a strong player.

Search

Optional. Works through Serper, or Tavily when signed in.

Language

English only.