sideboard 0.2.0__tar.gz

sideboard-0.2.0/.claude-plugin/marketplace.json

@@ -0,0 +1,14 @@
+{
+  "name": "sideboard",
+  "owner": {
+    "name": "zappleg8"
+  },
+  "plugins": [
+    {
+      "name": "sideboard",
+      "source": "./",
+      "description": "Play chess against Chesster, inline in Claude Code",
+      "version": "0.2.0"
+    }
+  ]
+}

sideboard-0.2.0/.claude-plugin/plugin.json

@@ -0,0 +1,22 @@
+{
+  "name": "sideboard",
+  "version": "0.2.0",
+  "description": "Play chess against Chesster, inline in Claude Code",
+  "author": {
+    "name": "Zach Applegate"
+  },
+  "repository": "https://github.com/zappleg8/sideboard",
+  "license": "MIT",
+  "keywords": [
+    "chess",
+    "game",
+    "claude-code"
+  ],
+  "skills": "./skills/",
+  "mcpServers": {
+    "sideboard": {
+      "command": "uvx",
+      "args": ["--from", "sideboard", "sideboard-mcp"]
+    }
+  }
+}

sideboard-0.2.0/.git

@@ -0,0 +1 @@
+gitdir: /Users/zachtireseasy/code/personal/sideboard/.git/worktrees/sideboard-plugin

sideboard-0.2.0/.gitignore

@@ -0,0 +1,16 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.worktrees/
+.claude/
+docs/superpowers/

sideboard-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zach Applegate
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sideboard-0.2.0/PKG-INFO

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: sideboard
+Version: 0.2.0
+Summary: Chess in your terminal. Play against Chesster while your coding agent thinks.
+Author: Zach Applegate
+License-Expression: MIT
+License-File: LICENSE
+Keywords: chess,claude-code,idle-game,terminal,tui
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Games/Entertainment :: Board Games
+Requires-Python: >=3.11
+Requires-Dist: mcp>=1.0
+Requires-Dist: python-chess>=1.0
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Sideboard
+
+**Play chess against Chesster, inline in [Claude Code](https://docs.anthropic.com/en/docs/claude-code).**
+
+```
+    a   b   c   d   e   f   g   h
+  ┌───┬───┬───┬───┬───┬───┬───┬───┐
+8 │ ♖ │ ♘ │ ♗ │ ♕ │ ♔ │ ♗ │ ♘ │ ♖ │ 8
+  ├───┼───┼───┼───┼───┼───┼───┼───┤
+7 │ ♙ │ ♙ │ ♙ │ ♙ │ ♙ │ ♙ │ ♙ │ ♙ │ 7
+  ├───┼───┼───┼───┼───┼───┼───┼───┤
+6 │   │   │   │   │   │ ♘ │   │   │ 6
+  ├───┼───┼───┼───┼───┼───┼───┼───┤
+5 │   │   │   │   │   │   │   │   │ 5
+  ├───┼───┼───┼───┼───┼───┼───┼───┤
+4 │   │   │   │   │ ♟ │   │   │   │ 4
+  ├───┼───┼───┼───┼───┼───┼───┼───┤
+3 │   │   │   │   │   │   │   │   │ 3
+  ├───┼───┼───┼───┼───┼───┼───┼───┤
+2 │ ♟ │ ♟ │ ♟ │ ♟ │   │ ♟ │ ♟ │ ♟ │ 2
+  ├───┼───┼───┼───┼───┼───┼───┼───┤
+1 │ ♜ │ ♞ │ ♝ │ ♛ │ ♚ │ ♝ │ ♞ │ ♜ │ 1
+  └───┴───┴───┴───┴───┴───┴───┴───┘
+    a   b   c   d   e   f   g   h
+
+Chesster: Alekhine's Defense — bold of you to invite the bayonet.
+```
+
+A chess game that lives inside your Claude Code conversation, for when the coding agent is grinding through a slow build.
+
+## Install (Claude Code)
+
+You'll need [uv](https://github.com/astral-sh/uv) on your `PATH` — the MCP server runs via `uvx`. Install with `brew install uv` if you don't have it.
+
+In Claude Code:
+
+```
+/plugin marketplace add zappleg8/sideboard
+/plugin install sideboard@sideboard
+```
+
+That's it. No pip, no shell config, no daemons.
+
+## Play
+
+```
+/sideboard:play             # start or resume a game
+/sideboard:play e4          # make a move (SAN: e4, Nf3, O-O, Bxe5, e8=Q)
+/sideboard:board            # re-render the current state silently
+/sideboard:resign           # resign and archive the PGN
+```
+
+One global game, persisted at `~/.sideboard/`. Quit Claude Code, come back tomorrow, the position is still there.
+
+## Standalone CLI (no Claude Code)
+
+If you'd rather play in a regular terminal:
+
+```bash
+pip install sideboard
+sideboard                          # new game vs Chesster
+sideboard --difficulty casual      # beginner-friendly
+sideboard --difficulty shark       # bring your A-game
+sideboard resume                   # pick up where you left off
+sideboard stats                    # your record vs Chesster
+```
+
+Terminal mode renders a colored Rich-styled board with proper chess glyphs.
+
+## How It Works
+
+A small Claude Code plugin packages three pieces:
+
+- A **slash-command skill** (`/sideboard:play`) that tells Claude to drive the game.
+- An **MCP server** (`sideboard-mcp`, launched via `uvx`) that exposes the chess engine and game state as tools (`new_game`, `make_move`, `engine_response`, `get_state`, `resign`, `get_stats`).
+- The **engine** is local Python — minimax with alpha-beta pruning, piece-square tables, and a curated Chesster quip pool that reacts to captures, checks, blunders, and brilliancies.
+
+Each move is two MCP calls: `make_move` applies your move and returns the engine's top three candidates plus a Chesster quip; `engine_response` plays whichever candidate Claude picks. The board renders in the conversation as a fenced code block.
+
+## Difficulty
+
+| Level | Search depth | Behavior |
+|---|---|---|
+| `casual` | 2 ply | Occasionally picks an off-best move for variety |
+| `club` | 3 ply | Default — solid, beatable |
+| `shark` | 4 ply + quiescence | Sees tactics; will hurt you |
+
+## Dependencies
+
+- [python-chess](https://python-chess.readthedocs.io/) — board state, move legality, PGN export
+- [mcp](https://github.com/modelcontextprotocol/python-sdk) — Claude Code plugin server
+- [Rich](https://rich.readthedocs.io/) — only for the standalone terminal CLI
+
+## License
+
+MIT

sideboard-0.2.0/README.md

@@ -0,0 +1,96 @@
+# Sideboard
+
+**Play chess against Chesster, inline in [Claude Code](https://docs.anthropic.com/en/docs/claude-code).**
+
+```
+    a   b   c   d   e   f   g   h
+  ┌───┬───┬───┬───┬───┬───┬───┬───┐
+8 │ ♖ │ ♘ │ ♗ │ ♕ │ ♔ │ ♗ │ ♘ │ ♖ │ 8
+  ├───┼───┼───┼───┼───┼───┼───┼───┤
+7 │ ♙ │ ♙ │ ♙ │ ♙ │ ♙ │ ♙ │ ♙ │ ♙ │ 7
+  ├───┼───┼───┼───┼───┼───┼───┼───┤
+6 │   │   │   │   │   │ ♘ │   │   │ 6
+  ├───┼───┼───┼───┼───┼───┼───┼───┤
+5 │   │   │   │   │   │   │   │   │ 5
+  ├───┼───┼───┼───┼───┼───┼───┼───┤
+4 │   │   │   │   │ ♟ │   │   │   │ 4
+  ├───┼───┼───┼───┼───┼───┼───┼───┤
+3 │   │   │   │   │   │   │   │   │ 3
+  ├───┼───┼───┼───┼───┼───┼───┼───┤
+2 │ ♟ │ ♟ │ ♟ │ ♟ │   │ ♟ │ ♟ │ ♟ │ 2
+  ├───┼───┼───┼───┼───┼───┼───┼───┤
+1 │ ♜ │ ♞ │ ♝ │ ♛ │ ♚ │ ♝ │ ♞ │ ♜ │ 1
+  └───┴───┴───┴───┴───┴───┴───┴───┘
+    a   b   c   d   e   f   g   h
+
+Chesster: Alekhine's Defense — bold of you to invite the bayonet.
+```
+
+A chess game that lives inside your Claude Code conversation, for when the coding agent is grinding through a slow build.
+
+## Install (Claude Code)
+
+You'll need [uv](https://github.com/astral-sh/uv) on your `PATH` — the MCP server runs via `uvx`. Install with `brew install uv` if you don't have it.
+
+In Claude Code:
+
+```
+/plugin marketplace add zappleg8/sideboard
+/plugin install sideboard@sideboard
+```
+
+That's it. No pip, no shell config, no daemons.
+
+## Play
+
+```
+/sideboard:play             # start or resume a game
+/sideboard:play e4          # make a move (SAN: e4, Nf3, O-O, Bxe5, e8=Q)
+/sideboard:board            # re-render the current state silently
+/sideboard:resign           # resign and archive the PGN
+```
+
+One global game, persisted at `~/.sideboard/`. Quit Claude Code, come back tomorrow, the position is still there.
+
+## Standalone CLI (no Claude Code)
+
+If you'd rather play in a regular terminal:
+
+```bash
+pip install sideboard
+sideboard                          # new game vs Chesster
+sideboard --difficulty casual      # beginner-friendly
+sideboard --difficulty shark       # bring your A-game
+sideboard resume                   # pick up where you left off
+sideboard stats                    # your record vs Chesster
+```
+
+Terminal mode renders a colored Rich-styled board with proper chess glyphs.
+
+## How It Works
+
+A small Claude Code plugin packages three pieces:
+
+- A **slash-command skill** (`/sideboard:play`) that tells Claude to drive the game.
+- An **MCP server** (`sideboard-mcp`, launched via `uvx`) that exposes the chess engine and game state as tools (`new_game`, `make_move`, `engine_response`, `get_state`, `resign`, `get_stats`).
+- The **engine** is local Python — minimax with alpha-beta pruning, piece-square tables, and a curated Chesster quip pool that reacts to captures, checks, blunders, and brilliancies.
+
+Each move is two MCP calls: `make_move` applies your move and returns the engine's top three candidates plus a Chesster quip; `engine_response` plays whichever candidate Claude picks. The board renders in the conversation as a fenced code block.
+
+## Difficulty
+
+| Level | Search depth | Behavior |
+|---|---|---|
+| `casual` | 2 ply | Occasionally picks an off-best move for variety |
+| `club` | 3 ply | Default — solid, beatable |
+| `shark` | 4 ply + quiescence | Sees tactics; will hurt you |
+
+## Dependencies
+
+- [python-chess](https://python-chess.readthedocs.io/) — board state, move legality, PGN export
+- [mcp](https://github.com/modelcontextprotocol/python-sdk) — Claude Code plugin server
+- [Rich](https://rich.readthedocs.io/) — only for the standalone terminal CLI
+
+## License
+
+MIT

sideboard-0.2.0/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "sideboard"
+version = "0.2.0"
+description = "Chess in your terminal. Play against Chesster while your coding agent thinks."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.11"
+authors = [{ name = "Zach Applegate" }]
+keywords = ["chess", "terminal", "tui", "claude-code", "idle-game"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Games/Entertainment :: Board Games",
+]
+dependencies = [
+    "python-chess>=1.0",
+    "rich>=13.0",
+    "mcp>=1.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+]
+
+[project.scripts]
+sideboard = "sideboard.cli:main"
+sideboard-mcp = "sideboard.mcp_server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/sideboard"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

sideboard-0.2.0/skills/board/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: board
+description: "Show the current chess board state without making a move"
+---
+
+# /board
+
+Read-only refresh. Use when the user has scrolled away and wants to see the current state.
+
+1. Call `mcp__sideboard__get_state`.
+2. If the response contains `error: "No active game."`, tell the user there's no active game and suggest `/play` to start one. Stop.
+3. Otherwise, render:
+
+````
+```
+{board_render}
+```
+````
+
+Then a status line: `_Move {move_number}, {turn} to play. Difficulty: {difficulty}._`
+
+Do not display `chesster_msg` here — `/board` is silent.

sideboard-0.2.0/skills/play/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: play
+description: "Play chess against Chesster, the witty engine"
+---
+
+# /play
+
+You are running the Sideboard chess game. The user is playing against Chesster, an overconfident chess engine with personality. You are NOT Chesster — you are the move executor and the renderer.
+
+## How to handle `/play` with no argument
+
+1. Call `mcp__sideboard__get_state`.
+2. If the response contains `error: "No active game."`, call `mcp__sideboard__new_game` with defaults (`difficulty: "club"`, `color: "white"`).
+3. Render the response using the format below.
+
+## How to handle `/play <move>` (e.g. `/play e4`, `/play Nf3`, `/play O-O`)
+
+1. Call `mcp__sideboard__make_move(san=<move>)`.
+2. If the response has `valid: false`:
+   - Show the `error` field.
+   - Show the first ~10 entries of `legal_moves`.
+   - Stop. The user retries with a different move.
+3. If valid:
+   - Render the response (board + Chesster line).
+   - If `game_over: true`, render the result and stop.
+   - From `engine_suggestions` (list of `[san, score]` pairs), pick the first one. Occasionally — say 1 turn in 5 — pick the second one for variety. **Never** pick beyond index 2.
+   - Call `mcp__sideboard__engine_response(san=<chosen_san>)`.
+   - Render the new response.
+   - If `game_over: true`, render the result and stop.
+
+## Rendering format
+
+Always render the board inside a triple-backtick fenced code block (no language tag), so monospace alignment holds:
+
+````
+```
+{board_render}
+```
+````
+
+Then on the next line, render Chesster's line as: `**Chesster:** _{chesster_msg}_`
+
+(Skip the Chesster line if `chesster_msg` is empty.)
+
+If `move_number` and `turn` fields are present, include a small status line below the board: `_Move {move_number}, {turn} to play._`
+
+## Hard rules
+
+- Do NOT invent Chesster lines. Only render the `chesster_msg` returned by the tool.
+- Do NOT recommend moves to the player. The user plays. You render.
+- Do NOT replay the player's move in the engine_response slot. The two-phase tools already handle that — `make_move` applies the player's move, `engine_response` applies Chesster's.
+- If the user types a move that's clearly a chat message and not SAN ("hi", "what should I play"), respond conversationally without calling tools.

sideboard-0.2.0/skills/resign/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: resign
+description: "Resign the current chess game"
+---
+
+# /resign
+
+1. Call `mcp__sideboard__resign`.
+2. If the response contains `error: "No active game."`, tell the user there's no active game. Stop.
+3. Otherwise, render:
+
+````
+```
+{board_render}
+```
+````
+
+Then on subsequent lines:
+- `**Chesster:** _{chesster_msg}_`
+- A blank line.
+- `**Game saved.** {stats summary as W:N L:N D:N}`
+- The PGN inside a fenced block, no language tag.

sideboard-0.2.0/src/sideboard/__init__.py

@@ -0,0 +1,3 @@
+"""Sideboard — chess in your terminal."""
+
+__version__ = "0.1.0"

sideboard-0.2.0/src/sideboard/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running as: python -m sideboard"""
+
+from sideboard.cli import main
+
+main()