{"id":50554013,"url":"https://github.com/softchris/cli-pirates","last_synced_at":"2026-06-04T05:05:11.214Z","repository":{"id":357709762,"uuid":"1238215845","full_name":"softchris/cli-pirates","owner":"softchris","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-13T23:34:59.000Z","size":59175,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-14T01:40:42.565Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/softchris.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-13T23:30:30.000Z","updated_at":"2026-05-13T23:35:02.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/softchris/cli-pirates","commit_stats":null,"previous_names":["softchris/cli-pirates"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/softchris/cli-pirates","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/softchris%2Fcli-pirates","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/softchris%2Fcli-pirates/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/softchris%2Fcli-pirates/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/softchris%2Fcli-pirates/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/softchris","download_url":"https://codeload.github.com/softchris/cli-pirates/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/softchris%2Fcli-pirates/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33890054,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-04T02:00:06.755Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-04T05:05:10.332Z","updated_at":"2026-06-04T05:05:11.208Z","avatar_url":"https://github.com/softchris.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ⚓ Copilot CLI Pirates\n\nA 3D pirate-themed quiz game built with Three.js where you sail the seas, conquer knowledge islands, and battle enemy ships — all while learning GitHub Copilot CLI commands!\n\n![Splash Screen](screenshots/01-splash.png)\n\n## 🎮 Play Now\n\n👉 **[Play Copilot CLI Pirates](https://softchris.github.io/cli-pirates/)**\n\n## 🌊 Overview\n\n**Copilot CLI Pirates** turns learning into an adventure. Each of the 7 islands represents a lesson from the [GitHub Copilot CLI for Beginners](https://github.com/github/copilot-cli-for-beginners) course. Sail your ship to an island, answer quiz questions to conquer it, and fight pirate ships when you get answers wrong!\n\n### Key Features\n\n- 🏝️ **7 Knowledge Islands** — Each island maps to a lesson from the Copilot CLI course\n- ⚔️ **Naval Combat** — Cannon battles with enemy pirate ships using 3D physics\n- 🧠 **Quiz System** — 21 questions across 7 lessons with multiple choice answers\n- 🚢 **90+ Captains** — Choose from real GitHub/Microsoft Cloud Advocates with unique stats\n- 💻 **In-Game Terminal** — Type real Copilot CLI commands that trigger game effects\n- 🏆 **27 Badges** — Achievements across 6 categories (combat, exploration, knowledge, etc.)\n- 🗺️ **8 Quests** — Complete quests to unlock legendary GitHub mascot captains\n- 📊 **Leveling \u0026 Skills** — XP system with a skill tree (Navigation, Combat, Knowledge, Leadership)\n- 💾 **Auto-Save** — Progress persisted via localStorage\n- 🔗 **Social Sharing** — Share your progress on X, LinkedIn, Bluesky, and Reddit\n- 🎵 **Dynamic Audio** — Background music, combat sounds, and ambient effects\n\n## 📸 Screenshots\n\n### Captain Selection\nChoose from 90+ captains — real Cloud Advocates with pirate names and unique stats.\n\n![Captain Selection](screenshots/02-captain-select.png)\n\n## 🎮 How to Play\n\n### Controls\n\n| Key | Action |\n|-----|--------|\n| **W / ↑** | Sail forward |\n| **S / ↓** | Sail backward |\n| **A / ←** | Turn left |\n| **D / →** | Turn right |\n| **Space** | Fire cannons |\n| **T** | Open terminal |\n| **B** | Open badges/quests |\n| **ESC** | Pause / Menu |\n\n### Gameplay Loop\n\n1. **Choose your captain** — Each has unique HP, speed, and damage stats\n2. **Sail to an island** — Navigate the open seas to find knowledge islands\n3. **Answer quiz questions** — Get 3 correct to conquer the island\n4. **Fight enemy ships** — Wrong answers spawn aggressive pirate ships\n5. **Level up** — Earn XP from combat, quests, and island conquests\n6. **Unlock skills** — Spend skill points on Navigation, Combat, Knowledge, or Leadership\n7. **Complete quests** — Unlock legendary GitHub mascot captains\n8. **Earn badges** — 27 achievements to collect\n\n## 🏝️ The Seven Islands\n\nEach island represents a lesson from the Copilot CLI for Beginners course:\n\n| # | Island | Lesson Topic |\n|---|--------|-------------|\n| 1 | **Intro Isle** | Introduction to Copilot CLI |\n| 2 | **Setup Shore** | Installation \u0026 Setup |\n| 3 | **Prompt Peninsula** | Prompt Engineering |\n| 4 | **Code Cove** | Code Generation |\n| 5 | **Debug Bay** | Debugging with Copilot |\n| 6 | **Test Reef** | Testing Assistance |\n| 7 | **Deploy Depths** | Deployment \u0026 CI/CD |\n\n## 💻 In-Game Terminal (27 Commands)\n\nPress **T** to open the terminal. Type real Copilot CLI commands to trigger game effects!\n\n| Command | Real CLI Purpose | Game Effect |\n|---------|-----------------|-------------|\n| `/help` | Show available commands | List all terminal commands |\n| `/model` | Switch AI model | Change ship type (Galleon/Frigate/Sloop) |\n| `/context` | Set file context | Reveal nearest island quiz answers |\n| `/clear` | Clear terminal | Clear terminal output |\n| `/diff` | Show code changes | Intel on nearby enemies |\n| `/plan` | Create implementation plan | Show island conquest strategy |\n| `/research` | Deep research mode | Discover hidden treasure locations |\n| `/version` | Show CLI version | Display game version \u0026 stats |\n| `/share` | Share session | Copy shareable progress link |\n| `/fleet` | — | Summon allied NPC ships |\n| `/repair` | — | Repair ship hull |\n| `/skills` | — | Open skill tree |\n| `/agent` | Delegate to AI agent | Summon ghost ship that auto-hunts enemies |\n| `/memory` | Access conversation memory | Random buff from past voyages |\n| `/mcp` | Model Context Protocol | \"Mystic Cannon Protocol\" — triple damage |\n| `/init` | Initialize project | Reset all cooldowns + temporary shield |\n| `/pr` | Create pull request | Loot magnet — pulls drops toward ship |\n| `/issue` | Create GitHub issue | Mark enemy for double damage |\n| `/commit` | Commit changes | HP floor lock — can't go below current HP |\n| `/status` | Show git status | Full battlefield status report |\n| `/review` | Code review | Scan nearest enemy's stats |\n| `/delegate` | Delegate task | Auto-heal 2 HP/s for 10s |\n| `/test` | Run tests | 360° cannon barrage |\n| `/credits` | — | Show game credits |\n| `/lore` | — | Show island lore |\n| `/sea` | — | Spawn sea creatures |\n| `/weather` | — | Change weather effects |\n\n## 🏆 Badges (27 Achievements)\n\n### Categories\n\n- **⚔️ Combat** — Ship battles and destruction milestones\n- **🧭 Exploration** — Visiting islands and sailing distances\n- **🧠 Knowledge** — Quiz performance and streaks\n- **📈 Progression** — Leveling up and skill upgrades\n- **💰 Economy** — Gold earning and spending\n- **🎯 Miscellaneous** — Special achievements\n\n### Tiers\n- 🥉 **Bronze** — Entry-level achievements\n- 🥈 **Silver** — Intermediate milestones\n- 🥇 **Gold** — Master-level accomplishments\n\n## 🗺️ Quests \u0026 Legendary Captains\n\nComplete 8 quests to unlock GitHub mascot captains:\n\n| Quest | Requirement | Unlocks |\n|-------|------------|---------|\n| Octocat's Trial | Conquer 3 islands | **Mona** 🐙 |\n| Rubber Duck Debugging | Answer 10 questions correctly | **Ducky** 🦆 |\n| AI Apprentice | Use 8 different CLI commands | **Copilot** 🤖 |\n| The Unicorn Path | Reach level 10 | **Monacorn** 🦄 |\n| Wave Rider | Visit all 7 islands | **Surftocat** 🏄 |\n| Code Warrior | Sink 15 enemy ships | **Scottocat** 🏴 |\n| Power Overwhelming | Unlock 5 skills | **Steroidtocat** 💪 |\n| Rainbow Journey | Earn 10 badges | **Nyantocat** 🌈 |\n\n## 🚢 Captain System\n\n### 90+ Playable Captains\n\nCaptains are real GitHub \u0026 Microsoft Cloud Advocates with:\n- **Pirate names** (e.g., Aaron \"Cannonpowder\" Powell)\n- **GitHub avatars** from their real profiles\n- **Unique stats**: HP (4-8), Speed (0.7-1.3), Damage (0.8-1.2)\n- **Specialties** based on their real expertise\n\n### Ship Types (via `/model` command)\n\n| Ship | HP | Speed | Damage |\n|------|-----|-------|--------|\n| **Galleon** | High | Slow | Medium |\n| **Frigate** | Medium | Medium | Medium |\n| **Sloop** | Low | Fast | High |\n\n## 📊 Progression System\n\n### XP Sources\n- Conquering islands\n- Sinking enemy ships\n- Answering questions correctly\n- Completing quests\n\n### Skill Tree (4 Branches)\n\n- **🧭 Navigation** — Faster sailing, better turning\n- **⚔️ Combat** — More damage, faster reload\n- **🧠 Knowledge** — Quiz hints, bonus XP\n- **👑 Leadership** — Better crew, more gold\n\n## 🛠️ Technical Details\n\n### Built With\n- **[Three.js](https://threejs.org/)** — 3D rendering engine\n- **[Kenney Pirate Kit](https://kenney.nl/assets/pirate-kit)** — 3D ship and prop models (40 GLB files)\n- **Vanilla JavaScript** — No frameworks, pure JS game engine\n- **CSS3** — UI overlays, animations, and effects\n- **Web Audio API** — Procedural sound effects\n- **localStorage** — Save/load game progress\n\n### Architecture\n```\ncli-pirates/\n├── index.html          # Entry point\n├── css/style.css       # All UI styles\n├── js/\n│   ├── game.js         # Main game engine (~4000 lines)\n│   └── questions.js    # Quiz questions from 7 lessons\n├── models/             # 40 GLB 3D models (Kenney Pirate Kit)\n├── images/\n│   └── splash.png      # Splash screen artwork\n├── audio/              # Background music \u0026 sound effects\n└── screenshots/        # Playwright-captured screenshots\n```\n\n### Game Engine Features\n- Procedural ocean with animated waves\n- Dynamic weather system (clear, storm, fog)\n- Particle effects (explosions, splashes, treasure sparkles)\n- Enemy AI with aggro system and patrol routes\n- Collision detection for ships, islands, and cannonballs\n- Day/night cycle\n- Mini-map with real-time tracking\n\n## 🚀 Running Locally\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/softchris/cli-pirates.git\n   cd cli-pirates\n   ```\n\n2. Serve with any HTTP server:\n   ```bash\n   python -m http.server 8080\n   # or\n   npx serve .\n   ```\n\n3. Open `http://localhost:8080` in your browser\n\n## 📝 Credits\n\n- **3D Assets**: [Kenney Pirate Kit](https://kenney.nl/assets/pirate-kit) (CC0 License)\n- **Quiz Content**: [GitHub Copilot CLI for Beginners](https://github.com/github/copilot-cli-for-beginners)\n- **Captain Avatars**: GitHub profile photos of real Cloud Advocates\n- **Built with**: [Three.js](https://threejs.org/), vanilla JavaScript\n\n## 📄 License\n\nMIT License — see [LICENSE](LICENSE) for details.\n\n---\n\n*Set sail, answer questions, conquer islands, and master the Copilot CLI! ⚓🏴‍☠️*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoftchris%2Fcli-pirates","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoftchris%2Fcli-pirates","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoftchris%2Fcli-pirates/lists"}