github/copilot-sdk

Multi-platform SDK for integrating GitHub Copilot Agent into apps and services

GitHub Copilot SDKs

GitHub Copilot SDKs let you embed the same agentic engine that powers the Copilot CLI directly inside your own applications. Official packages are provided for Python, TypeScript/Node.js, Go, .NET, Java, and Rust. The SDKs handle launching the Copilot CLI in server mode, communicating over JSON‑RPC, and exposing high‑level methods for planning, tool invocation, file edits, custom agents, skills, and more – so you don’t have to build the orchestration yourself.

What you get

  • Unified API across six languages – each SDK mirrors the Copilot CLI capabilities.
  • Automatic CLI management (bundled for Node, Python, .NET; optional for Go, Java, Rust).
  • Agent runtime that performs planning, tool calls, and file modifications.
  • Custom agents / skills / tools – extend the built‑in functionality with your own logic.
  • Authentication options – GitHub‑signed‑in user, OAuth app, environment‑variable tokens, or BYOK (your own API keys for OpenAI, Anthropic, etc.).
  • Production‑ready – GA release, semantic versioning, and a changelog.

Quick start (any language)

  1. (Optional) Install the Copilot CLI – required only for Go, Java, and Rust unless you bundle it yourself.
  2. Install the SDK
    • Node: npm install @github/copilot-sdk
    • Python: pip install github-copilot-sdk
    • Go: go get github.com/github/copilot-sdk/go
    • .NET: dotnet add package GitHub.Copilot.SDK
    • Rust: cargo add github-copilot-sdk
    • Java: add com.github:copilot-sdk-java via Maven or Gradle.
  3. Read the language‑specific README for usage examples and API reference.
  4. Run your code – the SDK will start the Copilot CLI process, talk to it via JSON‑RPC, and let you invoke agents programmatically.

Where to learn more

  • Getting‑started guide – docs/getting‑started.md
  • Full documentation index – docs/README.md
  • Cookbook – practical recipes for common tasks across all languages.
  • Authentication docs – docs/auth/README.md
  • Feature guide – docs/features/README.md

License & contribution

  • Open‑source under the MIT license.
  • Contributions are welcomed via the standard GitHub pull‑request workflow (see CONTRIBUTING.md).

All information above is taken directly from the repository’s README.

Related

  • Project
  • Project
  • Dispatch
  • Project
  • Project