# Copilot Sdk

> Use GitHub Copilot SDK to programmatically call Copilot from Python. Use when integrating AI capabilities via Copilot CLI into applications.

- **Type:** Skill
- **Install:** `agentstack add skill-hevangel-media-agent-skills-copilot-sdk`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [hevangel](https://agentstack.voostack.com/s/hevangel)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [hevangel](https://github.com/hevangel)
- **Source:** https://github.com/hevangel/media-agent-skills/tree/main/skills/copilot-sdk

## Install

```sh
agentstack add skill-hevangel-media-agent-skills-copilot-sdk
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# GitHub Copilot SDK for Python

The GitHub Copilot SDK is a multi-platform SDK for integrating GitHub Copilot Agent into apps and services. It exposes the same engine behind Copilot CLI, providing a production-tested agent runtime you can invoke programmatically.

> **Note:** This SDK is in technical preview and may change in breaking ways.

## Reference

- Code Snippets: `scripts/`
- GitHub Repository: https://github.com/github/copilot-sdk
- PyPI Package: https://pypi.org/project/github-copilot-sdk/

## Prerequisites

1. **GitHub Copilot Subscription**: Required
2. **Copilot CLI**: Must be installed (`gh extension install github/gh-copilot`)
3. **Authentication**: Must be logged into GitHub CLI (`gh auth login`)

## Installation

```bash
uv pip install github-copilot-sdk
```

## Architecture

```
Your Application
       |
  SDK Client (Python)
       | JSON-RPC
  Copilot CLI (server mode)
```

## API Reference

### CopilotClient Options

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| `cli_path` | str | "copilot" | Path to CLI executable |
| `cli_url` | str | None | URL of existing CLI server |
| `cwd` | str | None | Working directory for CLI process |
| `port` | int | 0 | Server port (0 = random) |
| `use_stdio` | bool | True | Use stdio transport |
| `auto_start` | bool | True | Auto-start server |
| `auto_restart` | bool | True | Auto-restart on crash |

### CopilotClient Methods

| Method | Description |
|--------|-------------|
| `await client.start()` | Start the CLI server |
| `await client.stop()` | Stop the CLI server |
| `await client.create_session(config)` | Create a conversation session |
| `await client.resume_session(session_id)` | Resume existing session |
| `await client.get_models()` | Get available models |

### SessionConfig

| Option | Type | Description |
|--------|------|-------------|
| `model` | str | Model to use ("gpt-5", "claude-sonnet-4.5", etc.) |
| `tools` | list[Tool] | Custom tools exposed to the CLI |
| `streaming` | bool | Enable streaming responses |
| `mcp_servers` | dict | MCP server configurations |

### Event Types

| Event Type | Description |
|------------|-------------|
| `assistant.message` | Final assistant message |
| `assistant.message_delta` | Streaming message chunk |
| `session.idle` | Session finished processing |
| `tool.call` | Tool invocation |
| `error` | Error event |

## Available Free Models

- `gpt-5-mini`

## Basic Usage

```python
import asyncio
from copilot import CopilotClient

async def main():
    client = CopilotClient()
    await client.start()
    session = await client.create_session({"model": "gpt-4.1"})
    response = await session.send_and_wait({"prompt": "What is Python?"})
    print(response.data.content)
    await session.destroy()
    await client.stop()

asyncio.run(main())
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [hevangel](https://github.com/hevangel)
- **Source:** [hevangel/media-agent-skills](https://github.com/hevangel/media-agent-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-hevangel-media-agent-skills-copilot-sdk
- Seller: https://agentstack.voostack.com/s/hevangel
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.