Add JBang prerequisites and usage instructions to all cookbook recipes

Co-authored-by: brunoborges <129743+brunoborges@users.noreply.github.com>

Author: Copilot

src/site/markdown/cookbook/README.md

@@ -2,6 +2,25 @@
 
 This folder hosts short, practical recipes for using the GitHub Copilot SDK with Java. Each recipe is concise, copy‑pasteable, and points to fuller examples and tests.
 
+## Prerequisites
+
+All cookbook examples can be run directly using [JBang](https://www.jbang.dev/), which allows you to run Java code without a full project setup.
+
+**Install JBang:**
+
+```bash
+# macOS (using Homebrew)
+brew install jbangdev/tap/jbang
+
+# Linux/macOS (using curl)
+curl -Ls https://sh.jbang.dev | bash -s - app setup
+
+# Windows (using Scoop)
+scoop install jbang
+```
+
+For other installation methods, see the [JBang installation guide](https://www.jbang.dev/download/).
+
 ## Recipes
 
 - [Error Handling](error-handling.md): Handle errors gracefully including connection failures, timeouts, and cleanup.

src/site/markdown/cookbook/error-handling.md

@@ -2,12 +2,33 @@
 
 Handle errors gracefully in your Copilot SDK applications.
 
+## Prerequisites
+
+Install [JBang](https://www.jbang.dev/) to run these examples:
+
+```bash
+# macOS (using Homebrew)
+brew install jbangdev/tap/jbang
+
+# Linux/macOS (using curl)
+curl -Ls https://sh.jbang.dev | bash -s - app setup
+
+# Windows (using Scoop)
+scoop install jbang
+```
+
 ## Example scenario
 
 You need to handle various error conditions like connection failures, timeouts, and invalid responses.
 
 ## Basic error handling
 
+**Usage:**
+```bash
+jbang BasicErrorHandling.java
+```
+
+**Code:**
 ```java
 //DEPS io.github.copilot-community-sdk:copilot-sdk:${project.version}
 import com.github.copilot.sdk.*;

src/site/markdown/cookbook/managing-local-files.md

@@ -2,12 +2,33 @@
 
 Use Copilot to intelligently organize files in a folder based on their metadata.
 
+## Prerequisites
+
+Install [JBang](https://www.jbang.dev/) to run these examples:
+
+```bash
+# macOS (using Homebrew)
+brew install jbangdev/tap/jbang
+
+# Linux/macOS (using curl)
+curl -Ls https://sh.jbang.dev | bash -s - app setup
+
+# Windows (using Scoop)
+scoop install jbang
+```
+
 ## Example scenario
 
 You have a folder with many files and want to organize them into subfolders based on metadata like file type, creation date, size, or other attributes. Copilot can analyze the files and suggest or execute a grouping strategy.
 
 ## Example code
 
+**Usage:**
+```bash
+jbang ManagingLocalFiles.java
+```
+
+**Code:**
 ```java
 //DEPS io.github.copilot-community-sdk:copilot-sdk:${project.version}
 import com.github.copilot.sdk.*;

src/site/markdown/cookbook/multiple-sessions.md

@@ -2,12 +2,33 @@
 
 Manage multiple independent conversations simultaneously.
 
+## Prerequisites
+
+Install [JBang](https://www.jbang.dev/) to run these examples:
+
+```bash
+# macOS (using Homebrew)
+brew install jbangdev/tap/jbang
+
+# Linux/macOS (using curl)
+curl -Ls https://sh.jbang.dev | bash -s - app setup
+
+# Windows (using Scoop)
+scoop install jbang
+```
+
 ## Example scenario
 
 You need to run multiple conversations in parallel, each with its own context and history.
 
 ## Java
 
+**Usage:**
+```bash
+jbang MultipleSessions.java
+```
+
+**Code:**
 ```java
 //DEPS io.github.copilot-community-sdk:copilot-sdk:${project.version}
 import com.github.copilot.sdk.*;

src/site/markdown/cookbook/persisting-sessions.md

@@ -2,12 +2,33 @@
 
 Save and restore conversation sessions across application restarts.
 
+## Prerequisites
+
+Install [JBang](https://www.jbang.dev/) to run these examples:
+
+```bash
+# macOS (using Homebrew)
+brew install jbangdev/tap/jbang
+
+# Linux/macOS (using curl)
+curl -Ls https://sh.jbang.dev | bash -s - app setup
+
+# Windows (using Scoop)
+scoop install jbang
+```
+
 ## Example scenario
 
 You want users to be able to continue a conversation even after closing and reopening your application.
 
 ## Creating a session with a custom ID
 
+**Usage:**
+```bash
+jbang PersistingSessions.java
+```
+
+**Code:**
 ```java
 //DEPS io.github.copilot-community-sdk:copilot-sdk:${project.version}
 import com.github.copilot.sdk.*;

src/site/markdown/cookbook/pr-visualization.md

@@ -2,30 +2,33 @@
 
 Build an interactive CLI tool that visualizes pull request age distribution for a GitHub repository using Copilot's built-in capabilities.
 
-## Example scenario
+## Prerequisites
 
-You want to understand how long PRs have been open in a repository. This tool detects the current Git repo or accepts a repo as input, then lets Copilot fetch PR data via the GitHub MCP Server and generate a chart image.
+Install [JBang](https://www.jbang.dev/) to run this example:
 
-## Prerequisites
+```bash
+# macOS (using Homebrew)
+brew install jbangdev/tap/jbang
 
-Add the following dependency to your `pom.xml`:
+# Linux/macOS (using curl)
+curl -Ls https://sh.jbang.dev | bash -s - app setup
 
-```xml
-<dependency>
-    <groupId>io.github.copilot-community-sdk</groupId>
-    <artifactId>copilot-sdk</artifactId>
-    <version>1.0.8</version>
-</dependency>
+# Windows (using Scoop)
+scoop install jbang
 ```
 
+## Example scenario
+
+You want to understand how long PRs have been open in a repository. This tool detects the current Git repo or accepts a repo as input, then lets Copilot fetch PR data via the GitHub MCP Server and generate a chart image.
+
 ## Usage
 
 ```bash
 # Auto-detect from current git repo
-java PRVisualization.java
+jbang PRVisualization.java
 
 # Specify a repo explicitly
-java PRVisualization.java github/copilot-sdk
+jbang PRVisualization.java github/copilot-sdk
 ```
 
 ## Full example: PRVisualization.java
@@ -222,14 +225,3 @@ public class PRVisualization {
 | Flexibility     | Fixed logic       | **AI decides best approach**      |
 | Chart types     | What you coded    | **Any type Copilot can generate** |
 | Data grouping   | Hardcoded buckets | **Intelligent grouping**          |
-
-## Running with JBang
-
-You can also run this example directly with JBang:
-
-```bash
-//DEPS io.github.copilot-community-sdk:copilot-sdk:${project.version}
-
-# Then run:
-jbang PRVisualization.java github/copilot-sdk
-```