Learn GitHub Copilot's parallel agent features through a Titanic-themed escape room.
- GitHub Copilot CLI installed
- GitHub Copilot subscription (Opus access recommended for best results)
- Node.js 18+ installed
- Clone this repo
- Run
npm install - Start the escape room:
copilot -i "/start" --model "claude-opus-4.8"
You'll see a Titanic banner and the welcome lesson. Type /progress anytime to see your voyage progress.
| Act | Setting | Topic |
|---|---|---|
| 1 | The Drawing Office | Subagents & the task tool |
| 2 | The Sea Trials | MCP servers & parallel puzzle-solving |
| 3 | The Maiden Voyage | Fleet coordination with shared tasks & messaging |
| Command | What it does |
|---|---|
/start |
Start or resume from where you left off |
/next |
Advance to next lesson |
/skip |
Skip current exercise |
/hint |
Get a progressive hint |
/progress |
See your voyage progress |
/reset |
Factory reset — wipe all progress and start over |
Puzzle-solver agents write JavaScript instead of using the MCP tools (Acts 2 and 3)
If a spawned agent tries to solve a puzzle by writing or running JavaScript against server/ instead of calling the claim_puzzle and submit_solution MCP tools, its Copilot CLI build is hiding the MCP tools from subagents (see github/copilot-cli#3812).
The root .mcp.json already sets "deferTools": "never" on the titanic-escape server, which keeps its tools available to every subagent and fixes this on recent CLI versions. If your version still hides them, disable tool search globally by adding "toolSearch": false to ~/.copilot/config.json (the location honours the COPILOT_HOME environment variable):
{
"toolSearch": false
}Restart Copilot CLI, or run /mcp reload, after changing either file.
The Titanic was built at Harland & Wolff in Belfast's Titanic Quarter. This tutorial was built by Instil, also in Belfast.