agent-framework-github-copilot

What it is and what it does

This package bridges the Microsoft Agent Framework with GitHub Copilot by providing a GitHubCopilotAgent class that lets you register tools and handle permission requests through Copilot's native SDK. Rather than using the standard Agent Framework approval round-trip, tool approval is enforced through Copilot's pre-execution hook system, which means the SDK owns the tool-calling loop and you configure approval behavior through callbacks like on_permission_request.

The package handles the common case automatically: if you mark a tool with approval_mode="always_require" and don't supply your own on_pre_tool_use hook, GitHubCopilotAgent installs a default hook that routes approval decisions to your on_permission_request handler. You can approve calls, deny them, or grant session-scoped approval that persists for the rest of the session. If you do provide a custom hook, you take full responsibility for enforcing approval, including for any approval-required tools.

Use it for:

• Build an agent that uses GitHub Copilot to execute file operations or shell commands with explicit user approval for each sensitive action.
• Integrate Copilot's agentic capabilities into an existing Agent Framework application to leverage Copilot's tool-calling loop.
• Implement session-scoped permission policies where certain tools or domains are approved once and remain approved for the duration of the session.
• Migrate from the deprecated on_function_approval callback to the newer on_pre_tool_use + on_permission_request model for tool approval.
• Create a custom permission handler that routes approval requests to an external system (audit log, user prompt, policy engine).

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Integrates GitHub Copilot's agentic capabilities into the Microsoft Agent Framework, enabling tool use and permission handling through Copilot's native SDK.

Yes. The package is actively maintained, has no known vulnerabilities, uses a permissive MIT license, and integrates cleanly with low install friction. Install it if you are already using the Microsoft Agent Framework and want to leverage GitHub Copilot's native agentic capabilities with built-in permission handling. Skip it if you do not need Copilot integration or prefer the standard Agent Framework approval model.

Install

agent-framework-github-copilot on PyPI

pip install agent-framework-github-copilot

uv add agent-framework-github-copilot

poetry add agent-framework-github-copilot

Installing agent-framework-github-copilot

Before you install

Low friction install with two runtime dependencies (agent-framework-core, github-copilot-sdk). Package is actively maintained as of 2026-08-14 with a recent release cycle and no known vulnerabilities.

License in practice

Licensed under MIT (permissive), imposing no significant restrictions on use or redistribution.

Quickstart

pip install agent-framework-github-copilot

from agent_framework import tool
from agent_framework.github import GitHubCopilotAgent, GitHubCopilotOptions
from copilot.session import PermissionHandler

@tool(approval_mode="always_require")
def delete_file(path: str) -> str:
    return f"Deleted {path}"

agent = GitHubCopilotAgent(
    tools=[delete_file],
    default_options=GitHubCopilotOptions(on_permission_request=PermissionHandler.approve_all)
)

Requires Python 3.11 or later; github-copilot-sdk must be available in your environment.

Verify before relying

• Whether the default on_pre_tool_use hook behavior is suitable for production use without custom override.
• Performance characteristics and latency of tool approval round-trips through Copilot's native hook system.
• Scope and limitations of session-scoped approval decisions when can_offer_session_approval=False.

Package facts

Evidence: agent_framework_github_copilot-1.0.2-py3-none-any.whl

Tags

More Application Frameworks packages

Further reading