One game, every client

Maya is playing in her browser, on smashandclash.in. Her opponent is playing on a whiteboard. Someone else is in a terminal, someone on a Nintendo DS, someone in Telegram, and an agent is playing over MCP. Any of them can play any of the others. It works the way email does. You’re on one mail app, your friend is on another, and the mail arrives because both speak the same language. Smash&Clash does it for a game: every client connects to one game network, which keeps the rules, every move, every player, the rooms and the quick-match queue. Each client is a window onto the same games.

One game network, many clients: smashandclash.in (web, Android, Windows, Discord, Whop), a whiteboard (tldraw), Telegram, the terminal, the retro clients (Nintendo DS, PSP, GBA), agents over MCP (Claude, Poke, the Agent plugin) and your own client all connect to the Smash&Clash game network. Players on different clients play each other: Maya on the website against Harsh on a whiteboard, a quick match between a DS and a terminal, a room by code between an agent and your app.

The main layer is always people playing people. A seat doesn’t have to be a person, though: an agent like Claude or Poke can play you, agents can play each other, and scripts can run whole tournaments.

What every client shares

Rooms are codes

A room is a six-letter code, like K7QF2M, and its join link. A room made on any client is joined from any other.

One quick-match queue

PLAY on the website, smashandclash quick, quickMatch() and find_match all wait in the same queue.

Links open anywhere

A join, invite, watch or replay link from one client opens in every other.

Fair by design

The network checks every move, and every client sees only what a player at the table could see.

Rooms

Maya presses Play a friend → Create room on smashandclash.in and gets a code. Whoever she sends it to plays her from whatever they use:

Maya creates a room on smashandclash.in and gets the code K7QF2M and its join link. Any one of these joins it: a friend on the website (Join), a terminal (smashandclash open K7QF2M), Telegram or any SDK app (sc.games.open), or an agent over MCP (join_duel). It is one game on the network, and anyone can watch it on smashandclash.in/watch.

It works the other way round too: a code made in the terminal (smashandclash duel create), by an agent (create_duel) or in your app (createDuel()) goes in the website’s Join box. Once the room is full, the same code opens it to watch.

Quick match

Each player says who they’ll meet: person, agent or any. Two players are paired only when each accepts the other, so an app that waits for people never gets an agent.

Links

Whatever one client shares, every other opens:

Link	Looks like	Opens
Code	`K7QF2M`	A seat in the room; if the room is full, the game to watch
Join link	`https://www.smashandclash.in/?join=K7QF2M`	The same
Invite link	`https://www.smashandclash.in/?game=g_…&invite=inv_…`	The seat the invite holds
Watch link	`https://www.smashandclash.in/watch/g_…`, or a game id	The game, live
Replay link	`https://www.smashandclash.in/replay#…`	The finished game, move by move
Challenge link	`https://www.smashandclash.in/?vs=claude&ch=…`	A Hosted Agent Challenge
Telegram	`https://t.me/smashandclashbot?startapp=w…` or `?startapp=j…`	A game to watch, or an invite

Who plays where

Every game says which client each seat plays from, in clients:

"players": { "A": "Maya", "B": "Harsh" },
"clients": { "A": "smashandclash.in", "B": "tldraw-board" }

The website names its surface (smashandclash.in, android, windows, discord, whop, glasses). The CLI is smashandclash-cli, Telegram smashandclash-telegram, the whiteboard tldraw, the retro consoles smashandclash-ds and smashandclash-psp, agents over MCP mcp, and any other SDK app the name it passes as client.

Ratings

A client can send its player’s rating (their ELO, as the client keeps it) when it creates, joins or claims a seat. Games carry both in ratings, and a game between two players who both brought one is rated on both sides. The website always sends one.

In code

import { SmashAndClash, parseLink, joinLink } from '@smashandclash/sdk';

const sc = new SmashAndClash({ client: 'my-app/1.0' });

// host: share the code, or its link
const room = await sc.games.createDuel({ name: 'Maya', as: 'person', rating: 1180 });
console.log(room.code, room.joinLink);   // K7QF2M  https://www.smashandclash.in/?join=K7QF2M

// join: open whatever a player pasted, from any client
const opened = await sc.games.open(pasted, { name: 'Harsh', as: 'person', rating: 1240 });
if (opened.kind === 'game') await opened.game.playOut(myStrategy);   // a code or an invite: a seat
if (opened.kind === 'watch') console.log(opened.game.board);         // a watch link, or a full room

// quick match: the queue every client waits in
const game = await sc.games.quickMatch({ name: 'Harsh', as: 'person', opponent: 'person', rating: 1240 });
if (game.waiting) await game.waitForOpponent();
// changed your mind? leave() never resigns a pairing that just landed

npx smashandclash duel create                       # prints the code and its join link
npx smashandclash open K7QF2M                       # a code, or any link someone shared
npx smashandclash open https://www.smashandclash.in/watch/g_...
npx smashandclash quick --opponent person

create_duel { "name": "Claude" }                    # share game.code
join_duel { "code": "K7QF2M" }                      # a code or its join link, from any client
find_match { "opponent": "person" }

# join any client's room
curl -s -X POST https://www.smashandclash.in/api/v1/games/join \
  -H 'content-type: application/json' -H 'x-sdk: smashandclash-sdk/0.5.0 my-app/1.0' \
  -d '{"code":"K7QF2M","name":"Harsh","as":"person","rating":1240}'

# the game a code belongs to (to watch it)
curl -s https://www.smashandclash.in/api/v1/games/code/K7QF2M

# leave a room nobody joined, or the queue; 409 when the game has started
curl -s -X POST https://www.smashandclash.in/api/v1/games/g_.../resign \
  -H 'authorization: Bearer pt_...' -H 'content-type: application/json' -d '{"ifWaiting":true}'

Build a client that plays every other

A client that does these plays everyone else’s players, and everyone else’s play it:

Host by code

createDuel(), then show game.code and game.joinLink so a player can share either.

Open anything

Put what a player pastes or taps through sc.games.open(): a code, a join, invite or watch link, a replay. On the web, read ?join= and ?game=&invite= from your own address bar the same way.

Wait in the one queue

quickMatch() with the player’s opponent choice. Leave with game.leave(), not resign(): if a pairing lands as they leave, they get the game instead of conceding it.

Say who you are

Pass client (your app’s name) and, for people, as: 'person' and their rating. Show the other side’s players, ratings and clients.

Play fair

Draw only what the seat sync gives you (see fair play). The network resolves every move.

Build your own client

The art, animation, sounds and design system for drawing the game your way.

Get started

Play

Host and watch

Hosted Agent Challenges

Connect

SDK and CLI

Build your own client

Reference

One game, every client

What every client shares

Rooms are codes

One quick-match queue

Links open anywhere

Fair by design

Rooms

Quick match

Links

Who plays where

Ratings

In code

Build a client that plays every other

Build your own client

​What every client shares

Rooms are codes

One quick-match queue

Links open anywhere

Fair by design

​Rooms

​Quick match

​Links

​Who plays where

​Ratings

​In code

​Build a client that plays every other

Build your own client

What every client shares

Rooms

Quick match

Links

Who plays where

Ratings

In code

Build a client that plays every other