feat(github-copilot): add example for running GitHub Copilot CLI in O…

[kinfey]

This pull request adds a new example for running the official GitHub Copilot CLI inside an OpenSandbox container. It includes a complete, well-documented workflow, a sample script, and supporting documentation to help users set up and run the Copilot CLI in an isolated environment.

New GitHub Copilot CLI Example in OpenSandbox:

Documentation and Usage Instructions

• Added a detailed guide (docs/examples/github-copilot-cli-sandbox.md) explaining how to run the GitHub Copilot CLI inside a local OpenSandbox container, including prerequisites, environment variables, and security notes.
• Added a short README (examples/github-copilot-cli-sandbox/README.md) pointing to the full documentation.

Example Implementation

• Added a Python script (examples/github-copilot-cli-sandbox/main.py) that:
  • Loads environment variables and checks for a required GitHub token.
  • Connects to the local OpenSandbox server and creates a sandbox container.
  • Installs the Copilot CLI using the official installation script.
  • Runs a prompt non-interactively with copilot -sp and prints logs.
  • Cleans up the sandbox after execution.…penSandbox

[Copilot]

Copilot review overview

🟡 Changes recommended

The documented setup contains failing commands, incorrect paths, and undiscoverable documentation.

Review effort: Balanced
Findings: 2 · 4

Open (6)

• Run uv sync from the server directory · New
• Fix example command path and include required packages · New
• Add GitHub Copilot CLI example to Examples index · New
• Remove inaccurate opensandbox-server version warning · New
• Fix nonexistent source URL · New
• Align link label with actual documentation path · New

What changed in this PR

Adds a GitHub Copilot CLI example running inside an OpenSandbox container.

Changes:

• Adds an asynchronous Python example with token handling and cleanup.
• Documents local setup, configuration, and security guidance.
• Adds a short example README.

File	Description
examples/​github-copilot-cli-sandbox/​README.md	Links to the full guide.
examples/​github-copilot-cli-sandbox/​main.py	Creates a sandbox and runs Copilot CLI.
docs/​examples/​github-copilot-cli-sandbox.md	Documents setup and usage.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

Copilot review overview

🟡 Changes recommended

Several documented commands and links are broken, dependencies are not reproducible, and unrelated framework changes should be separated.

Review effort: Balanced
Findings: 5 · 3

Open (8)

• Fix the server installation and run instructions · New
• Document the active Copilot subscription prerequisite · New
• Remove unrelated Microsoft Agent Framework changes · New
• Add a project manifest and lockfile for dependencies · New
• Add .env.example or document direct .env creation · New
• Add the example to both documentation navigation locations · New
• Use the canonical full GitHub source URL · New
• Restore the complete standard Apache-2.0 header · New

Resolved since last review (6)

• Fix example command path and include required packages
• Run uv sync from the server directory
• Align link label with actual documentation path
• Fix nonexistent source URL
• Remove inaccurate opensandbox-server version warning
• Add GitHub Copilot CLI example to Examples index

[Copilot]

Copilot review overview

🔵 Needs a closer look

Setup commands and links are broken, navigation entries are missing, and unrelated framework changes are outside the stated scope.

Review effort: Balanced
Findings: None

Resolved since last review (8)

• Add .env.example or document direct .env creation
• Add a project manifest and lockfile for dependencies
• Remove unrelated Microsoft Agent Framework changes
• Document the active Copilot subscription prerequisite
• Fix the server installation and run instructions
• Restore the complete standard Apache-2.0 header
• Use the canonical full GitHub source URL
• Add the example to both documentation navigation locations

Previously missed (2)

In code that hasn't changed since last review

Add project metadata or explicit dependency installation instructions

docs/​examples/​github-copilot-cli-sandbox.md:31

uv sync cannot prepare this example from the repository root because there is no root pyproject.toml or uv.lock, and this example has no manifest declaring opensandbox or python-dotenv. As written, the setup stops here (or the script later fails to import its dependencies); document explicit installs or add runnable project metadata.

This issue also appears in the following locations of the same file:

• line 46
• line 56
• line 89

Link directly to the example source on GitHub

docs/​examples/​microsoft-agent-framework.md:128

Source-code links in docs are required to use full GitHub URLs, and this relative repository path will also resolve as a VitePress page rather than a browsable source directory. Link directly to the example directory on GitHub.

[kinfey]

confirmed all

[jwx0925]

Reviewed ee84a61. Reproduced the documentation build failure and setup/path failures below. The Microsoft Agent Framework workflow passed a mock smoke test with the documented package versions; live Docker and model calls were not exercised.

[kinfey]

@jwx0925 please check it again

[Copilot]

Copilot review overview

🟡 Changes recommended

The documented Copilot setup is not currently runnable, links and navigation remain incorrect, and unrelated Microsoft example work conflicts with the stated scope.

Review effort: Balanced
Findings: 1 · 5

Open (6)

• Split Microsoft integration into a separate pull request · New
• Document explicit dependency installation for the standalone example · New
• Fix broken GitHub Copilot source link · New
• Remove reference to nonexistent pyproject.toml configuration · New
• Use the full GitHub URL for the source-code link · New
• Correct README link label to match the documentation path · New