main.py

import asyncio
import os
from copilot import CopilotClient


async def main():
    opts = {"github_token": os.environ.get("GITHUB_TOKEN")}
    if os.environ.get("COPILOT_CLI_PATH"):
        opts["cli_path"] = os.environ["COPILOT_CLI_PATH"]
    client = CopilotClient(opts)

    try:
        session = await client.create_session(
            {
                "model": "claude-haiku-4.5",
                "custom_agents": [
                    {
                        "name": "researcher",
                        "display_name": "Research Agent",
                        "description": "A research agent that can only read and search files, not modify them",
                        "tools": ["grep", "glob", "view"],
                        "prompt": "You are a research assistant. You can search and read files but cannot modify anything. When asked about your capabilities, list the tools you have access to.",
                    },
                ],
            }
        )

        response = await session.send_and_wait(
            {"prompt": "What custom agents are available? Describe the researcher agent and its capabilities."}
        )

        if response:
            print(response.data.content)

        await session.destroy()
    finally:
        await client.stop()


asyncio.run(main())