CopilotAdventures

Welcome to Copilot Adventures! This series of coding adventures is all about learning new concepts and languages by using GitHub Copilot to help you write code. Let’s get started!

Choose Your Own Copilot Adventure

1. Enter the Adventure Arena

To get started, enter the “adventure arena” by clicking the button below. This will create a GitHub Codespace that you can work in. Once it loads select the Create codespace button.

Enter Adventure Arena

NOTE: You can use 60 hours of GitHub Codespaces for free each month.

If you’d prefer, you can clone the repo and run locally:

git clone https://github.com/microsoft/copilotadventures

2. Choose an Adventure

Pre-Reqs: Basic programming language knowledge and experience with VS Code is helpful.

New to GitHub Copilot?

If you’re new to GitHub Copilot and want to learn how to get started using it, start with one of these warmup adventures:

Understanding GitHub Copilot Modes

GitHub Copilot offers three powerful interaction modes:

🤖 Agent Mode - Autonomous AI that can understand complex tasks, create entire projects from scratch, and work across multiple files. Perfect for building complete applications with minimal guidance. Agent mode can iterate on its own code, automatically identify and fix errors, and execute terminal commands.

✏️ Edit Mode - Multi-file editing experience that combines conversational flow with inline code suggestions. Copilot Edits can propose changes across multiple files, create new files, and provide fast iterative feedback for large-scale modifications.

💬 Ask Mode - Interactive chat mode where you collaborate step-by-step with Copilot through conversation. Great for learning, getting explanations, brainstorming solutions, and when you want more control over the process.


🤖 Agent Mode Adventures

Experience autonomous AI agent development with comprehensive project creation

Beginner Adventures

Intermediate Adventures

Advanced Adventures


💬 Ask Mode Adventures

Interactive collaboration with step-by-step guidance and learning

Beginner Adventures

Intermediate Adventures

Advanced Adventures

3. Start Coding

Read Your Copilot Adventure description, the high-Level tasks to perform, and the GitHub Copilot hints to help you write your code.

4. Submit Your Adventure Solution (Optional)

If you’d like to share your solution with others, perform the following steps:

Next Steps: Learn a New Language or Create a UI for Your Adventure

Once you’ve completed your first adventure, try it again but this time use GitHub Copilot to complete the adventure using a language that’s new to you. For example, if you normally write code in C#, use Copilot to help you solve the adventure using Python or another language you’d like to learn more about.

Try creating a UI for your adventure. Use pure HTML/CSS/JavaScript or a library/framework of your choosing. Let GitHub Copilot help you out with the UI code. If your UI requires images, consider using Bing Image Creator or another AI image generation service.

Have a Copilot Adventure Idea? Submit a PR!

Do you have a copilot adventure story/puzzle you’d like to submit for others to go through? We’d love to see it! Please submit a pull request to this repository with your adventure and solution.

We’ll review your submission and merge it into the repo if it meets the criteria.

Additional Resources

If you get stuck or have any questions about building AI apps, join our Azure AI Foundry Community Discord. If you have product feedback or errors while building visit our Azure AI Foundry Developer Forum.